Asana
Overview
Asana is a work management platform for organizing tasks, projects, and workflows. Integrate with Asana to create and manage tasks, projects, and workspaces from Suger and to automate task workflows.
Org-Level vs User-Level
Org-Level: Uses an Asana Service Account token for organization-wide access. Best for shared, company-wide automation.
User-Level: Uses OAuth to connect an individual’s Asana account for personal task and project management.
Create Integration (Org-Level)
Prerequisites
- An Asana Enterprise-tier plan (Service Accounts are an Enterprise feature)
- Super admin access to create a Service Account (Admin console → Apps → Service Accounts → Add Service Account)
Authenticate by Service Account Token
- Navigate to Settings > Integrations
- Click “Connect Asana”
- Enter your Asana Service Account token
- Verify the connection
Create User Integration
- Click
Connect Nowin the User Integrations section - You will be redirected to Asana to authorize
- Grant Suger access to your Asana account
- Return to Suger and verify the connection
Suger AI Tools
When Asana is connected, the Suger AI agent can manage work in Asana through Suger’s built-in tools (43 actions). Capabilities are grouped below.
Org-level and user-level: Both are supported; user-level takes precedence when both are connected.
| Capability | What the agent can do |
|---|---|
| Tasks | Create, read, update, and delete tasks and subtasks, and search a workspace (e.g. create-task, update-task, search-tasks-in-workspace) |
| Projects | Manage projects and task–project membership (e.g. create-project, add-project-to-task) |
| Sections | Organize tasks into project sections (e.g. create-section, list-tasks-for-section) |
| Tags | Manage tags and attach or detach them on tasks (e.g. create-tag, add-tag-to-task) |
| Stories & comments | Add and read comment threads on tasks (e.g. create-story-on-task, list-stories-for-task) |
| Workspaces, teams & users | Read org structure and the connected account (e.g. get-account, list-workspaces, list-users-for-workspace) |
Edit Integration
Editing is not supported. Delete and recreate.
Delete Integration
Deleting removes the integration from Suger.