> For the complete documentation index, see [llms.txt](https://docs.appmixer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.appmixer.com/connector-configuration/asana.md).

# Asana

## OAuth app properties

| Property                | Value                                                                                                                                                                                                                                   |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Multi-tenant**        | **Conditional.** One app serves users of any Asana workspace only when its distribution is set to **Any workspace**. A new app is private to its developer; with **Specific workspaces** it serves only workspaces you are a member of. |
| **Vendor review**       | **None.** Listing in the Asana App Directory is optional. Enterprise admins can approve or block apps in their organization.                                                                                                            |
| **Review time**         | Not applicable.                                                                                                                                                                                                                         |
| **Users before review** | No limit.                                                                                                                                                                                                                               |
| **App owner**           | Any Asana account.                                                                                                                                                                                                                      |
| **Regions**             | One app works worldwide.                                                                                                                                                                                                                |
| **Client secret**       | No expiry documented. It can be reset in the developer console.                                                                                                                                                                         |
| **Rate limits**         | Per token, not per app: 150 requests per minute for free workspaces, 1,500 for paid ones, and at most 50 concurrent reads and 15 concurrent writes.                                                                                     |
| **Checked**             | 2026-11-13                                                                                                                                                                                                                              |

**Limitations**

* Switching distribution from **Any workspace** back to **Specific workspaces** blocks new authorizations from users outside those workspaces.
* The connector does not request scopes, so the app needs **Full permissions** in its OAuth settings.
* Fill in the app listing details (icon, company, privacy policy) even if you do not publish the app. Enterprise admins use them to decide whether to approve or block it.

Sources: [OAuth](https://developers.asana.com/docs/oauth), [Manage distribution](https://developers.asana.com/docs/manage-distribution), [Rate limits](https://developers.asana.com/docs/rate-limits). What the rows mean: [OAuth app properties](https://docs.appmixer.com/connector-configuration/oauth-app-properties.md).

### 1. Create Asana account

Sign up with Asana: <https://app.asana.com>

### 2. Register OAuth app

To create an OAuth app with Asana, follow the oficial documentation: <https://developers.asana.com/docs/oauth#register-an-application>.

Take note of the application's client ID and the client secret (which should be protected as a password)

You will need to specify the `App name` and `Redirect URL` in this step.

* The `App name` can be anything you want.
* The `Redirect URL` should be the URL where Asana will redirect the user after they authorize your app. This depends on your environment, usually in the following format: `https://api.qa.appmixer.com/auth/asana/callback`

## Backoffice configuration

Configuration ID: `appmixer:asana` (Backoffice → Configuration; see [Connector Configuration](https://docs.appmixer.com/getting-started/services) for how a configuration is created and how its keys reach the connector).

* `clientId` — Client ID of the Asana app registered above. Not needed when Asana is authenticated through the Appmixer Auth Hub.
* `clientSecret` — Client secret of the same app. Not needed with the Auth Hub.
* `outputFilePrefix` — Optional. File name prefix of the CSV file that **ListProjects**, **ListTasks**, **ListTeams** and **ListUsers** create when their output is set to *File*; the file is named `<prefix>-<component name>.csv`. Default `asana-export`.

<figure><img src="https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-0aec1976037fb9d9c15df3ae29e27e798a9ccf73%2Fasana-1.png?alt=media" alt=""><figcaption><p>Backoffice Asana connector configuration</p></figcaption></figure>

The same keys can be set with the CLI (`-u` updates the existing configuration instead of creating it):

```bash
appmixer service-config set appmixer:asana -u -d '{
  "clientId": "<client id>",
  "clientSecret": "<client secret>"
}'
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.appmixer.com/connector-configuration/asana.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
