Asana

Index tasks and comments from Asana projects

How it works

The Asana connector pulls in tasks and their associated comments from specified projects or all projects in a workspace.

Setting up

Authorization

1. Create Personal Access Token

   • Log in to your Asana account and go to https://app.asana.com/0/my-apps
   • Click “Create New Personal Access Token”
   • Give it a name (e.g., “Onyx Integration”) and create the token
   • Copy the token — you’ll need to provide this to Onyx

Indexing

1. Open Asana connector

   Navigate to the Admin Panel and select the Asana Connector

2. Provide configuration

   • Asana API Token: Paste the Personal Access Token you created earlier
   • Workspace ID: Enter your Asana workspace ID. You can find this at https://app.asana.com/api/1.0/workspaces. It’s a number that looks like 1234567890123456.
   • Project IDs (optional): If you want to index specific projects, enter their IDs separated by commas. Leave this empty to index all projects in the workspace. Example: 1234567890123456,2345678901234567. You can find a project ID by clicking on a project in Asana. In the URL, it will look like https://app.asana.com/0/1208338159336610/1208338159510597, where “1208338159336610” is the project ID.
   • Team ID (optional): If you want to index team-visible tasks in addition to public tasks, enter a team ID. Leave this empty if you don’t need this feature.
3. Start indexing

   Click “Connect” to start the indexing process

Note: The connector will respect the permissions of the user associated with the provided API token. Ensure that this user has access to all the projects you want to index.