Skip to content
Last updated

Asana integration

Asana is a work management platform that helps teams organize, track, and manage their tasks and projects. The Frontegg integration with Asana allows your application to create, update, and manage tasks and projects on behalf of your users using OAuth 2.0.


Prerequisites

  • An Asana account with access to the developer console
  • Permissions to create apps in your Asana workspace

Connect Asana

Step 1: Open the Asana developer console

Go to app.asana.com/0/my-apps and sign in with your Asana account. This is the My apps page where you manage your OAuth applications.

Click Create new app.

Asana developer console

Step 2: Name your app

In the Create new app dialog, enter a name for your application. You can use any name that identifies this integration, for example Frontegg Integration.

Create new app dialog

Step 3: Agree to terms and create the app

Check I agree to the Asana API Terms, then click Create app.

App creation form with terms accepted

Step 4: Copy your credentials

After the app is created, you are taken to the Basic information page. Copy your Client ID — you will need it when configuring the integration in Frontegg.

Your Client Secret is also shown here. Copy it and store it securely — it is only shown once in full.

Basic information page with Client ID and Client Secret

Step 5: Navigate to the OAuth settings

In the left sidebar, click OAuth. This opens the OAuth & permissions page where you configure redirect URLs and permission scopes.

Click Add redirect URL.

OAuth page with Add redirect URL button

Step 6: Add redirect URLs

In the Add redirect URL dialog, enter the following URL and click Add:

https://YOUR_MCP_GATEWAY_URL/integration-callback

Add redirect URL dialog

Step 7: Select permission scopes

Scroll down to the Permission scopes section. Select the following scopes required for the integration:

ScopePermissionDescription
AttachmentsReadRead attachment details
Identity / OpenID ConnectOpenID, Email, ProfileAccess user identity and profile info
ProjectsRead, Write, DeleteManage projects
StoriesRead, WriteRead and create task comments
TagsRead, WriteManage task tags
TasksRead, Write, DeleteManage tasks
TeamsReadRead team information
UsersReadRead user information
WorkspacesReadRead workspace information

Permission scopes — top section

Permission scopes — tasks, stories, and tags

Step 8: Save your changes

Click Save changes. Asana will confirm that your settings were saved successfully.

OAuth page after saving

Configure the Frontegg portal

Once you have obtained your Client ID and Client Secret from the steps above, enter them in the integration configuration page of the Frontegg portal:

  1. Open the Frontegg portal and navigate to [ENVIRONMENT] → Integrations → Asana.
  2. Enter the Client ID and Client Secret in the corresponding fields.
  3. Select the required scopes.
  4. Click Save.

Keep your credentials secure

Never share or commit your Client Secret to version control.

Additional resources