Asana Connector
Prerequisites
- An Asana account (Basic, Premium, Business, or Enterprise)
- Access to the workspaces you want to sync
Getting Your Credentials
Asana uses a Personal Access Token for authentication.
- Log into Asana
- Click your profile icon in the top-right
- Go to My Settings > Apps > Developer Apps
- Under Personal Access Tokens, click Create new token
- Name it (e.g.,
Landed sync) - Copy the token (starts with
0/)
Important: The token inherits the permissions of your Asana user account. To sync all workspace data, use a token from an account with access to all relevant workspaces and projects.
Configuration in Landed
| Field | Value |
|---|---|
| Personal Access Token | Your Asana personal access token (starts with 0/) |
Available Streams
| Stream | Description | Sync Mode |
|---|---|---|
workspaces | Workspace/organization definitions | Full refresh |
users | User records with email and workspace memberships | Full refresh |
projects | Project records with owner, team, status, dates | Incremental |
tasks | Task records with assignee, due date, notes, tags, subtask count | Incremental |
sections | Project sections | Full refresh |
teams | Team definitions with description | Full refresh |
tags | Tag definitions | Full refresh |
custom_fields | Custom field definitions with options | Full refresh |
Common Issues
| Symptom | Cause | Fix |
|---|---|---|
401 Unauthorized | Invalid or expired token | Generate a new token in Asana > My Settings > Apps |
403 Forbidden | Token owner lacks access to project/workspace | Ensure the token owner is a member of the workspaces you want to sync |
| Missing tasks | Tasks in private projects | The token owner must be a member of private projects to sync their tasks |
Rate limit exceeded | Too many API calls | Landed handles rate limiting automatically |
Data Notes
- Asana requires explicit field selection (
opt_fields) on every request. Landed requests all standard fields for each stream. - Tasks include references to projects, tags, and parent tasks via GID fields
- Custom field values are available on tasks but synced separately in the
custom_fieldsstream
Static IPs for Allowlisting
If your network configuration requires IP allowlisting:
- Production:
34.170.185.84,35.192.90.94 - Staging:
34.171.93.34