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:
- Log into your Airbyte Cloud account.
- In the left navigation bar, click Sources. In the top-right corner, click +new source.
- Set the name for your source.
- Authenticate using OAuth (recommended) or enter your
personal_access_token. - 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:
- Navigate to the Airbyte Open Source dashboard.
- In the left navigation bar, click Sources. In the top-right corner, click +new source.
- Set the name for your source.
- Enter your
personal_access_token. - 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
- Projects
- Portfolios
- PortfolioMemberships
- Sections
- Stories
- Tags
- Tasks
- Teams
- Team Memberships
- 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.
Reference
Config fields reference
Field
Type
Property name
object
credentials
boolean
test_mode
array
organization_export_ids
Changelog
Expand to review
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 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 |