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.

Projects

Function name	Description	Type	Source code
`projects`	Retrieves all projects for a user	Sync	🔗 Github

Tasks

Function name	Description	Type	Source code
`create-task`	Create a task using Asana specific fields and return a unified model task. See https://developers.asana.com/reference/createtask for Asana specific fields	Action	🔗 Github
`delete-task`	Delete a task.	Action	🔗 Github
`update-task`	Update a task and be able to assign the task to a specific user	Action	🔗 Github
`tasks`	Retrieve all tasks that exist in the workspace	Sync	🔗 Github

Users

Function name	Description	Type	Source code
`users`	Retrieve all users that exist in the workspace	Sync	🔗 Github

Workspaces

Function name	Description	Type	Source code
`workspaces`	Retrieve all workspaces for a user	Sync	🔗 Github

Others

Function name	Description	Type	Source code
`fetch-projects`	Fetch the projects with a limit (default 10) given a workspace of a user to allow selection when choosing the tasks to sync.	Action	🔗 Github
`fetch-workspaces`	Fetch the workspaces with a limit (default 10) of a user to allow them to selection of projects to sync	Action	🔗 Github

API Guides

APIs & Integrations

🚀 Quickstart

📚 Asana Integration Guides

🧩 Pre-built syncs & actions for Asana

Projects

Tasks

Users

Workspaces

Others

API Guides

APIs & Integrations

​🚀 Quickstart

​📚 Asana Integration Guides

​🧩 Pre-built syncs & actions for Asana

​Projects

​Tasks

​Users

​Workspaces

​Others

🚀 Quickstart

📚 Asana Integration Guides

🧩 Pre-built syncs & actions for Asana

Projects

Tasks

Users

Workspaces

Others