Asana - Nango Docs

🚀 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.

🧩 Pre-built syncs & actions for Asana

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

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

​🚀 Quickstart

​📚 Asana Integration Guides

​🧩 Pre-built syncs & actions for Asana

​Others

🚀 Quickstart

📚 Asana Integration Guides

🧩 Pre-built syncs & actions for Asana

Others