Integration Guide: Asana

Published Date: June 1, 2026 | Last Updated: October 9, 2026

Overview

The Asana integration connects Seasoft Identity to the Asana organization using a Service Account token. Unlike OAuth integrations, Asana requires a token to be generated in the Asana Admin Console and entered into Seasoft Identity manually.

Before connecting

The Administrator completing this setup must have an Asana Admin account with access to the Asana Admin Console. The Service Account created for Seasoft Identity must be configured with Full permissions.

Step 1: Create a Service Account in Asana

1. Sign in to the Asana Admin Console.
2. In the left navigation, select Apps, then select Service accounts.
3. Select Add service account.
4. Enter a name (for example, Seasoft Identity Service Account) and an optional description.
5. Under Permission scopes, select Full permissions. Full permissions are required for Seasoft Identity to read user data and manage access in Asana.
6. Select Save changes.
7. Asana generates a token. Select Copy to copy the token immediately.

Important: The token is only displayed once. Copy it before closing the dialog. If the token is lost, a new service account must be created.

Step 2: Connect Asana in Seasoft Identity

1. Navigate to Integrations in the left navigation.
2. Select + Add Integration.
3. Search for Asana and select Add.
4. Paste the copied token into the Service Account Token field.
5. Select Test Connection to verify the token is valid. A Connection successful confirmation will appear if the token is accepted.
6. Select Connect. The integration appears on the Integrations page and an initial sync begins automatically.

Verify the connection

After the initial sync completes, confirm the following on the Integrations page:

• The Asana integration displays a status of Active
• A sync timestamp is present and reflects the completed sync
• User records on the Users page display detected Asana permissions in the Access column

Reauthorizing the connection

If the Asana integration loses authorization, it will display an error on the Integrations page. To reauthorize, generate a new Service Account token in the Asana Admin Console, then select the integration row in Seasoft Identity, select Configure, and enter the new token.

Related articles

• Configuring Integrations — manage sync schedules, drift detection, and integration settings
• Understanding Errors — resolve integration errors and authorization failures
• Asana: Service Accounts — Asana documentation for creating and managing service accounts