Asana
Read workspaces, projects, users, tasks, and statuses, then update task workflows
Connect Asana when a project needs to show or change work tracked in an Asana workspace. Shared connections use one authorized account for the project. Published apps can let each app user authorize their own account.
Before you connect
A Swarmz administrator must configure and enable the Asana OAuth application before the connector appears. Each user still signs in to Asana and approves access. The administrator's client secret is never the user's Asana credential.
Register the callback URL shown on the Swarmz admin integration card in the Asana developer console. Enable the read scopes for workspaces, users, projects, project statuses, sections, tasks, and stories. Enable the task, story, and project-status write scopes if projects will change Asana data.
Available operations
| Operation | What it does | Limit per minute |
|---|---|---|
list_workspaces | Lists workspaces available to the authorized user | 30 |
list_users | Lists users in one workspace | 30 |
list_projects | Lists active or archived projects | 30 |
list_tasks | Lists tasks in one project | 30 |
list_project_statuses | Lists project status updates | 30 |
create_task | Creates one task | 15 |
update_task | Changes task fields or completion | 15 |
add_task_comment | Adds one task comment | 15 |
create_project_status | Publishes one project status | 10 |
Connect Asana
Ask the AI for the workflow and name the connection mode. For a company dashboard, say: “Use our shared Asana connection to show incomplete tasks from the launch project.” For a published multi-tenant app, say: “Let each signed-in user connect Asana and list their projects.”
Select Connect new, choose read access, add write access only when the workflow needs it, then approve the request in Asana. See Connector connection modes for the shared and app-user difference.
Verify Asana
- List workspaces and projects, then confirm a known project name.
- List tasks from a test project.
- Create a task named
Swarmz connector test, update it to completed, and add a comment. - Confirm each change in Asana, then delete the test task in Asana.
If reads work but a write fails, reconnect with the matching write permission. If a workspace is missing, check that the authorized Asana user belongs to it and that the OAuth app is available in that workspace.