# Asana integration

> For the complete documentation index, see [llms.txt](/llms.txt)

> Create an Asana task from feedback in the project you choose.

Create an Asana task from feedback in the project you choose.

:::info
Asana is available on the [Professional](https://pushfeedback.com#pricing) and [Unlimited](https://pushfeedback.com#pricing) plans.
:::

![Configure the Asana destination, delivery controls, and task format in PushFeedback](./images/asana-configuration.jpg)

## Before you start

- Create an Asana personal access token by following [Asana's personal access token guide](https://developers.asana.com/docs/personal-access-token).
- To find the **Workspace GID**, sign in to Asana and open [the workspaces endpoint](https://app.asana.com/api/1.0/workspaces). Copy the `gid` beside the workspace you want.
- To find the **Project GID**, use Asana's [Get projects from a workspace endpoint](https://developers.asana.com/reference/getprojectsforworkspace) with that workspace GID. Copy the `gid` beside the destination project.
- Keep the token safe. PushFeedback encrypts it and never displays it again.

## Configure Asana

1. In the PushFeedback dashboard, open your project, then **Settings** > **Integrations** > **Asana**.
2. In **01 Connection and destination**, enter the token, workspace GID, and project GID. Add a destination name if it helps your team identify the project.
3. In **02 Delivery controls**, keep **Enabled** selected or pause delivery without losing the configuration. Select **Require a message** to skip rating-only feedback.
4. In **03 Message recipe**, set the task title and notes templates. You can insert feedback and project variables such as `{{ feedback.message }}` and `{{ feedback.detail_url }}`.
5. Add optional delivery rules under **Advanced rules and custom fields**.
6. On wider screens, review the live task preview while you edit. It does not contact Asana.
7. Save the integration, then select **Test connection** to validate the saved token and destination. The test does not create a task.

## Delivery behavior

When the integration is enabled, feedback matching your delivery controls and rules creates a task in the configured Asana project.

## Remove Asana

Open the Asana integration settings and select **Remove integration**. New feedback will no longer create Asana tasks.