Work management
Asana
Connect Asana to read projects, sections, and tasks, and to create, update, and complete tasks from Atlas.
What this connector does
- Read Asana workspaces, teams, projects, sections, tasks, tags, and people, a page at a time.
- Search the tasks of a workspace by text, project, assignee, or completion.
- Create, update, complete, and reopen tasks and subtasks.
- Read the comments on a task and add your own.
Before you begin
- You are an owner or administrator of your Atlas workspace.
- You can sign in to your Asana account and approve access for Atlas.
- Atlas looks after the Asana app on its side, so there is nothing for you to create or copy.
How to connect
Open Asana in Integrations
In Atlas, open Integrations and select Asana.
Press Connect
Atlas sends you to Asana to sign in. Sign in with the account you want to connect.
Approve access
Review the permissions that Asana lists and approve them. Atlas returns you to the connector page, which then shows the connection.
Check the connection
Select Test connection on the connector page. A passing result means Atlas can read from Asana.
Permissions Atlas asks for
defaultSetup checklist
- Confirm you are an owner or administrator of your Atlas workspace.
- Open Integrations and select the connector.
- Press Connect and sign in to Asana.
- Review the permissions that Asana lists and approve them.
- Select Test connection and read the result.
Troubleshooting
invalid_grant
The saved sign-in 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.
Connect says Asana is not available yet
Atlas has not enabled Asana for this deployment, so there is nothing for you to configure. Check again later.
The sign-in was cancelled
If you close the Asana screen or choose Cancel, Atlas does not connect. Press Connect again and approve the access.
Atlas asks you to reconnect
Asana can end a connection when access is revoked or a password changes. Press Reconnect on the connector page and approve the access again.
Event notifications
Atlas does not yet receive events from Asana. It reads Asana when you run an operation, so what you see is current at that moment.
Events Atlas listens for
- None yet. Atlas reads this connector when asked and does not receive events from it.
Provider docs: https://developers.asana.com/reference/rest-api-reference
Disconnect and data deletion
- Click Disconnect on the Atlas Asana connector page.
- Open developer console, Apps, and revoke the access given to Atlas Connector.
- Atlas stops reading Asana immediately on disconnect.
When you are ready, open the live connector page and press Connect to finish connecting Asana.
Open the Asana connector page