airbyte/docs/integrations/sources/asana.md

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:

Feature	Supported?
Full Refresh Sync	Yes
Incremental Sync	No
Namespaces	No

Supported Streams

• Attachments
• Custom fields
• Events
• Organization Exports
• Portfolio Items
• Portfolio Memberships
• Portfolios
• Projects
• Sections
• Sections Compact
• Stories
• Stories Compact
• Tags
• Tasks
• Team Memberships
• Teams
• Users
• Workspaces

Data type map

Integration Type	Airbyte Type
string	string
int, float, number	number
date	date
datetime	datetime
array	array
object	object

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.

Changelog

Expand to review

Version	Date	Pull Request	Subject
1.5.1	2025-12-09	70445	Fix organization_export_ids spec to properly define array items type
1.5.0	2025-05-02	59224	Adds portfolio_items stream to sync items (such as projects and portfolios) in each portfolio (API reference)
1.4.0	2025-04-25	58594	Adds actual_time_minute field to the task stream
1.3.10	2025-02-15	53891	Update dependencies
1.3.9	2025-02-08	53394	Update dependencies
1.3.8	2025-02-01	52882	Update dependencies
1.3.7	2025-01-25	52216	Update dependencies
1.3.6	2025-01-18	51750	Update dependencies
1.3.5	2025-01-11	51246	Update dependencies
1.3.4	2025-01-04	50915	Update dependencies
1.3.3	2024-12-28	50442	Update dependencies
1.3.2	2024-12-21	50195	Update dependencies
1.3.1	2024-12-14	48966	Starting 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.0	2024-12-06	48712	Upgrade to process full refresh and non-incremental substreams using concurrent CDK
1.2.14	2024-11-04	48175	Update dependencies
1.2.13	2024-10-28	47026	Update dependencies
1.2.12	2024-10-12	46825	Update dependencies
1.2.11	2024-10-05	46501	Update dependencies
1.2.10	2024-09-28	46166	Update dependencies
1.2.9	2024-09-21	45754	Update dependencies
1.2.8	2024-09-14	45547	Update dependencies
1.2.7	2024-09-07	45277	Update dependencies
1.2.6	2024-08-31	44970	Update dependencies
1.2.5	2024-08-24	44722	Update dependencies
1.2.4	2024-08-17	44275	Update dependencies
1.2.3	2024-08-12	43807	Update dependencies
1.2.2	2024-08-10	43532	Update dependencies
1.2.1	2024-08-03	43079	Update dependencies
1.2.0	2024-07-27	42856	Add task & target data to stories compact stream
1.1.1	2024-07-27	42801	Update dependencies
1.1.0	2024-07-24	42488	Add task data to stories stream
1.0.9	2024-07-20	42144	Update dependencies
1.0.8	2024-07-13	41839	Update dependencies
1.0.7	2024-07-10	41573	Update dependencies
1.0.6	2024-07-09	41142	Update dependencies
1.0.5	2024-07-06	40865	Update dependencies
1.0.4	2024-06-25	40392	Update dependencies
1.0.3	2024-06-22	40092	Update dependencies
1.0.2	2024-06-18	39551	Fix pagination from offset to cursor based, Increment airbyte_cdk to ^1
1.0.1	2024-06-06	39249	[autopull] Upgrade base image to v1.2.2
1.0.0	2024-04-15	36697	Migrate to low code
0.6.1	2023-11-13	31110	Fix hidden config access
0.6.0	2023-11-03	31110	Add new stream Portfolio Memberships with Parent Portfolio
0.5.0	2023-10-30	31114	Add Portfolios stream
0.4.0	2023-10-24	31084	Add StoriesCompact stream
0.3.0	2023-10-24	31634	Add OrganizationExports stream
0.2.0	2023-10-17	31090	Add Attachments stream
0.1.9	2023-10-16	31089	Add Events stream
0.1.8	2023-10-16	31009	Add SectionsCompact stream
0.1.7	2023-05-29	26716	Remove authSpecification from spec.json, use advancedAuth instead
0.1.6	2023-05-26	26653	Fix order of authentication methods
0.1.5	2022-11-16	19561	Added errors handling, updated SAT with new format
0.1.4	2022-08-18	15749	Add cache to project stream
0.1.3	2021-10-06	6832	Add oauth init flow parameters support
0.1.2	2021-09-24	6402	Fix SAT tests: update schemas and invalid_config.json file
0.1.1	2021-06-09	3973	Add entrypoint and bump version for connector
0.1.0	2021-05-25	3510	New Source: Asana