> ## Documentation Index
> Fetch the complete documentation index at: https://docs.connectstrata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Asana

> Provider ID: `Asana`

## Getting Started

You can connect to the Asana API using a Personal Access Token (PAT) or an OAuth app. For connecting a single Asana workspace, we recommend using a Personal Access Token.

### Personal Access Token Setup

<Steps>
  <Step title="Generate a Personal Access Token">
    1. Log in to [Asana](https://app.asana.com) and navigate to **My Settings > Apps > Developer Apps**.
    2. Click **Create new token**, provide a description (e.g. `Strata Integration`), and click **Create token**.
    3. Copy the token and store it in a secure location.

    <Note>
      The full token is only displayed once. After closing the creation dialog, it cannot be retrieved — you will need to create a new one if lost.
    </Note>
  </Step>

  <Step title="Configure the Asana Integration in Strata">
    Select Asana in the [Strata Integration Catalog](https://app.connectstrata.com/integrations/catalog). Enter your Personal Access Token.
  </Step>
</Steps>

### OAuth App Setup

<Steps>
  <Step title="Create an Asana OAuth App">
    1. Navigate to the [Asana Developer Console](https://app.asana.com/0/my-apps).
    2. Click **Create new app**, enter a name and select your workspace.
    3. In your app's settings, navigate to **OAuth** and add the Strata OAuth callback URL as a redirect URL:

    ```text theme={null}
    https://connect.connectstrata.com/oauth/callback
    ```

    4. Copy the **Client ID** and **Client Secret** from the app's settings page.
  </Step>

  <Step title="Configure the Asana Integration in Strata">
    Select Asana in the [Strata Integration Catalog](https://app.connectstrata.com/integrations/catalog). Enter your OAuth client ID, client secret, and required scopes.

    <Note>
      The scopes in the Strata dashboard should match the scopes you configured in your Asana OAuth app.
    </Note>
  </Step>
</Steps>

### Webhooks

Asana supports [webhooks](https://developers.asana.com/docs/webhooks-guide) for real-time event notifications. Webhooks are established per-resource (e.g. a project, task, or workspace) and require an active API connection.