Documentation

Description

Asana is a project management and team collaboration platform. Teams use Asana to organize, track, and manage work across projects, tasks, sections, portfolios, and goals.

Follow our setup guide to connect Asana to Improvado.

Step 1. Click the Make a new Connection on the Connections page.
Categories on the Data sources page group all available platforms. Use a search to find the required one.

Step 2. Click on the Asana tile.

Step 3. Choose authorization option:

{%docs-accordion title="OAuth (recommended)"%}

Step 3.1. Select OAuth (recommended) and click Connect. Before authorization, make sure you are signed in to the Asana account you want to extract data from.

Step 3.2. A popup window opens at app.asana.com. Sign in if needed.

Step 3.3. Review the requested permissions and click Allow. The popup closes and you are returned to Improvado.

Note: Improvado requests read-only scopes by default. Switch to Read & Write in the authorization form if you plan to use Reverse ETL.

{%docs-accordion-end%}

{%docs-accordion title="Personal Access Token"%}

Step 3.1. In a new tab, open the Asana Developer Console.

Step 3.2. Click Create new token, give it a descriptive name (for example, Improvado), and accept the developer terms.

Step 3.3. Copy the generated token immediately — it is shown only once.

Step 3.4. Paste the token into the API Key field on the Improvado authorization form and click Connect.

{%docs-accordion-end%}

Step 4. After the connection process is completed, the Asana connection will appear in your Connected sources list.

Step 5. When the connection status is Active, and the account status column shows a number of accounts (workspaces), you can move on to data extraction.

Step 6. To extract data from the connected sources, check the instructions on how to set up data extraction.

The schema information shows all report types you can use to extract data from Asana.