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

Changelog

Expand to review
VersionDatePull RequestSubject
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