## 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](https://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](/assets/asana-1.fa773abcbd29ecc562d54a914e38e6fc68fa686db5b62e3faab9bd559ee67b52.1ce25488.png)

#### 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](/assets/asana-2.e41e693a4d78d416478f06c7a596304270908e04f614b41f872155961110cfa5.1ce25488.png)

#### 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](/assets/asana-3.5586c06ae506019554c0d78e5dc72f49ec7fd3168dfd1394d96ed0ad879a3da0.1ce25488.png)

#### 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](/assets/asana-4.8b96827ed43fc5cef7c21f76cf232858c01f553245024af8a368bd8341a59fcd.1ce25488.png)

#### 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](/assets/asana-5.57c53fe2e91c8d1ff57b4fe3849a046fadaa09e0d639ac88779b221faa01fbc2.1ce25488.png)

#### 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](/assets/asana-6.556c71847415f39e73da4be5b48c2aa8250b308b0d080246c28152a9230072f4.1ce25488.png)

#### Step 7: Select permission scopes

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

| Scope | Permission | Description |
|  --- | --- | --- |
| Attachments | Read | Read attachment details |
| Identity / OpenID Connect | OpenID, Email, Profile | Access user identity and profile info |
| Projects | Read, Write, Delete | Manage projects |
| Stories | Read, Write | Read and create task comments |
| Tags | Read, Write | Manage task tags |
| Tasks | Read, Write, Delete | Manage tasks |
| Teams | Read | Read team information |
| Users | Read | Read user information |
| Workspaces | Read | Read workspace information |


![Permission scopes — top section](/assets/asana-7.11e1b5191d60be54442078780c9040fe1b1c40c307861f7fda495001ee068869.1ce25488.png)

![Permission scopes — tasks, stories, and tags](/assets/asana-8.65103f520fd94643d6eb2b2cc9542c20504ef56055ad65b47ef36746039d846b.1ce25488.png)

#### Step 8: Save your changes

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

![OAuth page after saving](/assets/asana-9.f284b9ffb758dd564402656199fc1e64a9a941fa5265dffce55d99d5c5258b44.1ce25488.png)

### 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

- [Asana API documentation](https://developers.asana.com/docs)
- [Asana developer console](https://app.asana.com/0/my-apps)
- [Asana OAuth scopes reference](https://developers.asana.com/docs/oauth-scopes)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)