Skip to main content

Asana

This page contains the setup guide and reference information for the Asana source connector.

Prerequisites

This connector supports OAuth and Personal Access Tokens. Please follow these steps to obtain Personal Access Token for your account.

Setup guide

For Airbyte Cloud:

  1. Log into your Airbyte Cloud account.
  2. In the left navigation bar, click Sources. In the top-right corner, click +new source.
  3. Set the name for your source.
  4. Authenticate using OAuth (recommended) or enter your personal_access_token.
  5. Click Set up source.

Syncing Multiple Projects

If you have access to multiple projects, Airbyte will sync data related to all projects you have access to. The ability to filter to specific projects is not available at this time.

For Airbyte Open Source:

  1. Navigate to the Airbyte Open Source dashboard.
  2. In the left navigation bar, click Sources. In the top-right corner, click +new source.
  3. Set the name for your source.
  4. Enter your personal_access_token.
  5. Click Set up source.

Supported sync modes

The Asana source connector supports the following sync modes:

FeatureSupported?
Full Refresh SyncYes
Incremental SyncNo
NamespacesNo

Supported Streams

Data type map

Integration TypeAirbyte Type
stringstring
int, float, numbernumber
datedate
datetimedatetime
arrayarray
objectobject

Limitations & Troubleshooting

Expand to see details about Asana connector limitations and troubleshooting.

Connector limitations

Rate limiting

The connector is restricted by Asana rate limits.

Troubleshooting

  • If you encounter access errors while using OAuth authentication, please make sure you've followed this Asana Article.
  • Check out common troubleshooting issues for the Asana source connector on our Airbyte Forum here.

Reference

Config fields reference

Field
Type
Property name
object
credentials
boolean
test_mode
array
organization_export_ids
integer
num_workers

Changelog

Expand to review
VersionDatePull RequestSubject
1.3.22024-12-2150195Update dependencies
1.3.12024-12-1448966Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64
1.3.02024-12-0648712Upgrade to process full refresh and non-incremental substreams using concurrent CDK
1.2.142024-11-0448175Update dependencies
1.2.132024-10-2847026Update dependencies
1.2.122024-10-1246825Update dependencies
1.2.112024-10-0546501Update dependencies
1.2.102024-09-2846166Update dependencies
1.2.92024-09-2145754Update dependencies
1.2.82024-09-1445547Update dependencies
1.2.72024-09-0745277Update dependencies
1.2.62024-08-3144970Update dependencies
1.2.52024-08-2444722Update dependencies
1.2.42024-08-1744275Update dependencies
1.2.32024-08-1243807Update dependencies
1.2.22024-08-1043532Update dependencies
1.2.12024-08-0343079Update dependencies
1.2.02024-07-2742856Add task & target data to stories compact stream
1.1.12024-07-2742801Update dependencies
1.1.02024-07-2442488Add task data to stories stream
1.0.92024-07-2042144Update dependencies
1.0.82024-07-1341839Update dependencies
1.0.72024-07-1041573Update dependencies
1.0.62024-07-0941142Update dependencies
1.0.52024-07-0640865Update dependencies
1.0.42024-06-2540392Update dependencies
1.0.32024-06-2240092Update dependencies
1.0.22024-06-1839551Fix pagination from offset to cursor based, Increment airbyte_cdk to ^1
1.0.12024-06-0639249[autopull] Upgrade base image to v1.2.2
1.0.02024-04-1536697Migrate to low code
0.6.12023-11-1331110Fix hidden config access
0.6.02023-11-0331110Add new stream Portfolio Memberships with Parent Portfolio
0.5.02023-10-3031114Add Portfolios stream
0.4.02023-10-2431084Add StoriesCompact stream
0.3.02023-10-2431634Add OrganizationExports stream
0.2.02023-10-1731090Add Attachments stream
0.1.92023-10-1631089Add Events stream
0.1.82023-10-1631009Add SectionsCompact stream
0.1.72023-05-2926716Remove authSpecification from spec.json, use advancedAuth instead
0.1.62023-05-2626653Fix order of authentication methods
0.1.52022-11-1619561Added errors handling, updated SAT with new format
0.1.42022-08-1815749Add cache to project stream
0.1.32021-10-066832Add oauth init flow parameters support
0.1.22021-09-246402Fix SAT tests: update schemas and invalid_config.json file
0.1.12021-06-093973Add entrypoint and bump version for connector
0.1.02021-05-253510New Source: Asana