AsanaWork management

• Sync Asana workspaces, teams, projects, and tasks into Atlas.
• Reflect status and assignee changes both directions after mapping approval.
• Convert Asana tasks into Atlas tasks without copying private notes.
• Listen for change events through Asana webhooks.

• You are an organization admin on Asana.
• OAuth apps are allowed for your organization.
• You have a sandbox project for first validation.

1. Create the provider app in a sandbox or development workspace.
2. Add the Atlas redirect URL to the provider app configuration.
3. Copy the client id, client secret, or API key.
4. Paste the credentials into the Atlas connector settings page.
5. Click Connect and complete the provider sign-in screen.
6. Run Test connection from the connector page to verify health.

• invalid_grant

  Refresh token expired or was revoked. Reconnect from Atlas.

• forbidden

  The connected user is not a member of the project. Add them or use a workspace-wide service account.

• webhook handshake failed

  Asana requires the receiver to echo X-Hook-Secret on registration. Atlas handles this only if the endpoint is reachable.

Atlas registers Asana webhooks per project and validates the X-Hook-Signature header on every event.

Events Atlas listens for

• Task created
• Task changed
• Task deleted
• Story added

Provider docs: https://developers.asana.com/docs/webhooks

1. Click Disconnect on the Atlas Asana connector page.
2. Open developer console, Apps, and revoke the Atlas Connector OAuth grant.
3. Atlas removes cached Asana data within 24 hours of disconnect.