Asana (Source)
Introduction
The Asana source connector lets you connect to the Asana API using a Personal Access Token (PAT).
Setup
Prerequisites
- An Asana account with access to the workspaces/projects you want to sync.
- An Asana Personal Access Token.
Create a Personal Access Token
- In Asana, go to My Profile Settings.
- Open the Apps tab.
- Under Personal access tokens, create a new token.
- Copy the token and store it securely (you won’t be able to view it again).
Authentication
This connector authenticates using an Asana Personal Access Token passed as a Bearer token to the Asana API.
The connector validates credentials by calling:
GET https://app.asana.com/api/1.0/users/me
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
personal_access_token | string | ✅ | Your Asana Personal Access Token (PAT). |
Streams
The connector extracts accessible Asana work-management resources, including workspaces, users, teams, projects, tasks, tags, goals, custom fields, portfolios, and supported relationship streams.
custom_fields
Loading ....
goal_parent_goals
Loading ....
goals
Loading ....
portfolio_items
Loading ....
portfolios
Loading ....
projects
Loading ....
tags
Loading ....
tasks
Loading ....
team_memberships
Loading ....
teams
Loading ....
users
Loading ....
workspaces
Loading ....
Notes
- The Asana source uses Asana’s Search endpoints for some streams when running in incremental mode. In particular, the
projectsandtasksstreams are fetched via workspace search when an incremental cursor is present, which can return results in an order that isn’t strictly chronological. - Because of this, incremental syncs may encounter duplicate records across pages or queries. The connector de-duplicates records during extraction to avoid emitting duplicates.