Asana

🚀 Quickstart

Connect to Asana with Nango and see data flow in 2 minutes.

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Asana.

Authorize Asana

Go to Connections -> Add Test Connection -> Authorize, then log in to Asana. Later, you’ll let your users do the same directly from your app.

Call the Asana API

Let’s make your first request to the Asana API (fetch a list of workspaces). Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/api/1.0/workspaces" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const res = await nango.get({
    endpoint: '/api/1.0/workspaces',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(res.data.data);

Or fetch credentials with the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.

📚 Asana Integration Guides

Nango maintained guides for common use cases.

How to register your own Asana OAuth app
Register an OAuth app with Asana and obtain credentials to connect it to Nango

Official docs: Asana API Documentation

🧩 Pre-built syncs & actions for Asana

Enable them in your dashboard. Extend and customize to fit your needs.

Attachments

Function name	Description	Type	Source code
`delete-attachment`	Delete an attachment by gid.	Action	🔗 Github
`list-attachments-for-object`	List attachments on a task or other supported object.	Action	🔗 Github

Projects

Function name	Description	Type	Source code
`create-project`	Create a project in a workspace or team.	Action	🔗 Github
`delete-project`	Delete a project by gid.	Action	🔗 Github
`get-project`	Fetch a single project by gid.	Action	🔗 Github
`list-projects-for-team`	List projects in a team.	Action	🔗 Github
`list-projects-for-workspace`	List projects in a workspace.	Action	🔗 Github
`update-project`	Update mutable fields on a project.	Action	🔗 Github

Sections

Function name	Description	Type	Source code
`create-section`	Create a section in a project.	Action	🔗 Github
`delete-section`	Delete a section by gid.	Action	🔗 Github
`get-section`	Fetch a single section by gid.	Action	🔗 Github
`list-sections-for-project`	List sections in a project.	Action	🔗 Github
`update-section`	Update mutable fields on a section.	Action	🔗 Github

Stories

Function name	Description	Type	Source code
`create-story-on-task`	Create a comment or story entry on a task.	Action	🔗 Github
`delete-story`	Delete a story or comment by gid.	Action	🔗 Github
`list-stories-for-task`	List stories and comments on a task.	Action	🔗 Github

Function name	Description	Type	Source code
`create-tag`	Create a tag in a workspace.	Action	🔗 Github
`delete-tag`	Delete a tag by gid.	Action	🔗 Github
`get-tag`	Fetch a single tag by gid.	Action	🔗 Github
`list-tags-for-workspace`	List tags in a workspace.	Action	🔗 Github
`update-tag`	Update mutable fields on a tag.	Action	🔗 Github

Tasks

Function name	Description	Type	Source code
`add-project-to-task`	Add a task to a project, optionally into a section.	Action	🔗 Github
`add-tag-to-task`	Attach an existing tag to a task.	Action	🔗 Github
`create-subtask`	Create a subtask under a parent task.	Action	🔗 Github
`create-task`	Create a task in Asana.	Action	🔗 Github
`delete-task`	Delete a task by gid.	Action	🔗 Github
`get-task`	Fetch a single task by gid.	Action	🔗 Github
`list-subtasks-for-task`	List subtasks under a parent task.	Action	🔗 Github
`list-tasks-for-project`	List tasks in a project.	Action	🔗 Github
`list-tasks-for-section`	List tasks in a project section.	Action	🔗 Github
`remove-project-from-task`	Remove a task from a project	Action	🔗 Github
`remove-tag-from-task`	Remove a tag from a task.	Action	🔗 Github
`search-tasks-in-workspace`	Search tasks in a workspace with filters.	Action	🔗 Github
`update-task`	Update mutable fields on a task.	Action	🔗 Github

Teams

Function name	Description	Type	Source code
`get-team`	Fetch a single team by gid.	Action	🔗 Github
`list-teams-for-user`	List teams for a user.	Action	🔗 Github
`list-teams-for-workspace`	List teams in a workspace.	Action	🔗 Github

Users

Function name	Description	Type	Source code
`get-user`	Fetch a single user by gid.	Action	🔗 Github
`list-users-for-team`	List users in a team.	Action	🔗 Github
`list-users-for-workspace`	List users in a workspace.	Action	🔗 Github

Workspaces

Function name	Description	Type	Source code
`get-workspace`	Fetch a single workspace by gid.	Action	🔗 Github
`list-workspaces`	List workspaces available to the authenticated user.	Action	🔗 Github

Others

Function name	Description	Type	Source code
`projects`	Sync projects for workspaces or teams in scope.	Sync	🔗 Github
`sections`	Sync sections for projects in scope	Sync	🔗 Github
`subtasks`	Sync subtasks for parent tasks in scope.	Sync	🔗 Github
`tags`	Sync workspace tags.	Sync	🔗 Github
`tasks`	Sync tasks for projects, sections, or workspace search scopes.	Sync	🔗 Github
`teams`	Sync teams for workspaces in scope.	Sync	🔗 Github
`users`	Sync users for workspaces or teams in scope.	Sync	🔗 Github
`workspaces`	Sync workspaces visible to the authenticated Asana user.	Sync	🔗 Github

Overview

700+ APIs & Integrations

🚀 Quickstart

📚 Asana Integration Guides

🧩 Pre-built syncs & actions for Asana

Attachments

Projects

Sections

Stories

Tags

Tasks

Teams

Users

Workspaces

Others

Overview

700+ APIs & Integrations

Documentation Index

​🚀 Quickstart

​📚 Asana Integration Guides

​🧩 Pre-built syncs & actions for Asana

​Attachments

​Projects

​Sections

​Stories

​Tags

​Tasks

​Teams

​Users

​Workspaces

​Others

🚀 Quickstart

📚 Asana Integration Guides

🧩 Pre-built syncs & actions for Asana

Attachments

Projects

Sections

Stories

Tags

Tasks

Teams

Users

Workspaces

Others