# Asana

Asana is a project management platform that helps teams organize tasks, track projects, and coordinate work. With Coupler.io, you can automatically export your Asana data — tasks, projects, users, and more — to spreadsheets, databases, or BI tools without writing a single line of code.

## Why connect Asana to Coupler.io?

* **Centralize project data** — pull tasks, sections, stories, and portfolios into one place for reporting
* **Track team performance** — combine Users and Tasks data to see workload distribution across your team
* **Build live dashboards** — send Asana data to Google Sheets, Looker Studio, BigQuery, or AI tools like ChatGPT or Gemini
* **Keep data fresh automatically** — schedule recurring exports so your reports always reflect the latest project status

## Prerequisites

* An active Asana account (Free, Premium, Business, or Enterprise)
* Your Asana account must belong to an **organization or team workspace** — personal project spaces do not support API access
* You must have access to the projects, portfolios, or workspaces you want to export

{% hint style="warning" %}
Asana's API does not work with personal project spaces. If you see a "Data cannot be fetched" error, make sure your account is part of an organization workspace, not a personal one.
{% endhint %}

## Quick start

{% hint style="success" %}
Start with the **Tasks** entity — it contains the richest data and is the most commonly used for reporting and analysis.
{% endhint %}

{% stepper %}
{% step %}
**Create a new data flow in Coupler.io.** Go to your Coupler.io account and click **Add data flow**. Search for and select **Asana** as your source.
{% endstep %}

{% step %}
**Connect your Asana account via OAuth.** Click **Connect** and sign in to Asana when prompted. Coupler.io uses OAuth, so no API keys are needed — just authorize access and you're in.
{% endstep %}

{% step %}
**Select an entity to export.** Choose the data entity you want — Tasks, Projects, Users, Portfolios, and more. See the table below for all available entities.
{% endstep %}

{% step %}
**Choose your destination.** Select where you want to send your data — Google Sheets, Excel, BigQuery, Looker Studio, PostgreSQL, or an AI destination like ChatGPT, Claude, or Gemini.
{% endstep %}

{% step %}
**Run your data flow.** Click **Run** to execute a manual run. Once it completes successfully, your Asana data will appear in your chosen destination.
{% endstep %}
{% endstepper %}

## Available entities

| Entity     | What it contains                                                   |
| ---------- | ------------------------------------------------------------------ |
| Tasks      | Task names, assignees, due dates, completion status, custom fields |
| Projects   | Project names, status, owners, due dates                           |
| Sections   | Sections within projects                                           |
| Stories    | Activity feed entries and comments on tasks                        |
| Tags       | Tags used across your workspace                                    |
| Teams      | Team names and membership info                                     |
| Users      | User names, emails, roles                                          |
| Portfolios | Portfolio names and associated projects (Business/Enterprise)      |
| Workspaces | Workspace names and IDs                                            |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.coupler.io/sources/category/project-management/asana.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.