Asana integration

Overview

Asana is a project management platform with strong support for project hierarchies, custom fields, and dependencies. The Automize Asana connector covers tasks, projects, sections, comments, attachments, users, and webhooks.

• Regions: Asana is a single global platform – app.asana.com. No region selector.
• Plans: Free, Starter, Advanced, Enterprise – all expose the API. Some features (custom fields, rules, portfolios) need Advanced or Enterprise.

Setting up the connection

Auth type: OAuth 2.0 (Authorization Code).

1. Sign in to Asana → click your avatar → My Apps → Create new app.
2. Set Redirect URI to the one shown in the Automize Asana connector dialog.
3. Copy the Client ID and Client Secret.
4. In Automize, open Settings → Connectors → Asana → Add connection. Paste credentials, click Connect with Asana, pick workspace, approve.

Scopes required:

• default

Find your credentials at https://app.asana.com/0/my-apps.

Rate limits

Asana enforces 150 requests/min for free plans, 1,500/min for paid plans (per user / per app combination). The connector retries 429 with the Retry-After header. Heavy reads should use the Search Tasks endpoint with specific filters rather than walking all tasks.

Data model

Hierarchy:

    Workspace ─┬─ Teams (Enterprise)
               ├─ Projects ─┬─ Sections
               │            └─ Tasks ─┬─ Sub-tasks
               │                      ├─ Comments (Stories)
               │                      ├─ Attachments
               │                      └─ Custom Fields
               └─ Users

A Task can belong to multiple projects (memberships).

Available operations

18 operations available. Click any row to jump to its detail.

Operations

Create project

Create a new project in Asana.

Tips

• Specify workspace (required) and team if you want it in a team's project list.

Create section

Create a section in an Asana project.

Tips

• project + name.

Add comment

Add a comment to an Asana task.

Create task

Create a new task in Asana.

Tips

• Must specify projects[] or workspace + assignee.
• name required. notes is the description (plain text or HTML if html_notes used).
• due_on for date, due_at for datetime.

Errors

• Not Authorized – Token doesn't have access to the target project/workspace.

Delete task

Delete an Asana task.

Tips

• Hard-delete. Asana retains in trash for 30 days but no API to restore.

Get current user

Get the authenticated Asana user profile.

No input parameters.

Get project

Get Asana project details.

Tips

• Returns project + memberships + custom_field_settings.

Get task

Get Asana task details by GID.

Tips

• Returns full task incl. custom fields, memberships, dependencies.
• opt_fields lets you project – useful for fast lookups.

List projects

List projects in an Asana workspace.

Tips

• Filter by workspace + team + archived.

List sections

List sections in an Asana project.

Tips

• Project sections (columns on a board view). Tasks belong to a section via memberships.

List comments

List comments/stories on an Asana task.

List subtasks

List subtasks of an Asana task.

List tags

List tags in an Asana workspace.

Tips

• Workspace tags. Useful for cross-project labelling.

List tasks

List tasks in an Asana project.

Tips

• Must specify a scope: project, section, user_task_list, assignee+workspace, or tag.
• completed_since=now to filter to active tasks; use ISO datetime for older cutoffs.
• opt_fields: comma list to project specific fields (e.g. name,due_on,assignee.name).

List users

List users in an Asana workspace.

Tips

• Filter by workspace + team.

List workspaces

List all workspaces the user has access to in Asana.

No input parameters.

Search tasks

Search tasks in an Asana workspace.

Tips

• Workspace-level search with filters: text, assignee.any, projects.any, sections.any, tags.any, completed.
• Up to 100 results per call.

Update task

Update an Asana task.

Tips

• PATCH-style. completed=true marks done; assignee=user_id reassigns.

FAQ

Workspace vs Team vs Organization – what's the difference?

Workspace is the top-level container (free/small teams). Organization is a workspace with domain verification (Business+/Enterprise). Teams are subdivisions within an Organization. Most APIs use workspace_id even for Organizations.

GID format – what's that?

Asana uses Global IDs (numeric strings). Pass them as strings, not integers – they exceed JS safe integer range.

Why does Search not return tasks I can see?

Search is workspace-scoped – verify you're searching the right workspace. Also: search is eventually consistent, very recently created tasks may take 30-60s to appear.

Custom fields – how do I update?

Pass custom_fields:{gid_of_field: value} in Update Task. For enum fields, value is the option GID; for text/number, the literal value.

Related connectors

• Clickup
• Monday
• Jira
• Trello