Skip to main content

Asana

Availability
Available CloudAvailable Self-Managed CommunityAvailable Self-Managed EnterpriseAvailable PyAirbyte
Support Level
Marketplace
Connector Version
1.5.0 (last updated 2 months ago)
CDK Version
6.33.6
Sync Success Rate
Usage Rate
Definition ID
d0243522-dccf-4978-8ba0-37ed47a0bdbf

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
integer
num_workers
array
organization_export_ids
boolean
test_mode

Changelog​

Expand to review
VersionDatePull RequestSubject
1.5.02025-05-0259224Adds portfolio_items stream to sync items (such as projects and portfolios) in each portfolio (API reference)
1.4.02025-04-2558594Adds actual_time_minute field to the task stream
1.3.102025-02-1553891Update dependencies
1.3.92025-02-0853394Update dependencies
1.3.82025-02-0152882Update dependencies
1.3.72025-01-2552216Update dependencies
1.3.62025-01-1851750Update dependencies
1.3.52025-01-1151246Update dependencies
1.3.42025-01-0450915Update dependencies
1.3.32024-12-2850442Update dependencies
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
Was this page helpful?