> For the complete documentation index, see [llms.txt](https://happybara.gitbook.io/streamly/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://happybara.gitbook.io/streamly/reference/integrations/tools/asana.md).

# Asana

### [Integration](/streamly/concepts/integration.md) specification

{% hint style="info" %}
The point of connection for a [**Stream**](/streamly/concepts/stream.md) in a tool is referred to as an **integration component**.

The **integration component** in Asana is the [**Project**](https://asana.com/guide/help/projects/basics)**.**
{% endhint %}

#### Each [Request](/streamly/concepts/request.md) submitted in a **Stream that is** [**connected**](/streamly/reference/streams/modify/tools.md) **to an Asana Project creates a** [**Task**](https://asana.com/guide/help/tasks) **in that Project.**

### Request field mapping

| **Field name**            | Asana Task field       |
| ------------------------- | ---------------------- |
| `Complete` (aka `Status`) | `Complete`             |
| `Requester`               | `Description` (bullet) |
| `Subject`                 | `Name`                 |
| `Assignee`                | `Assignee`             |
| `Due date`                | `Due date`             |

#### All other fields, including [user-created](/streamly/reference/streams/modify/field-library/create.md) fields, are added to the Asana Task `Description` as bullets.

### Slack message deep linking

#### Each Task that is created in Asana will be connected to the corresponding Request [message](/streamly/reference/requests/submit.md) in Slack via a deep link.

{% hint style="info" %}
The **deep link** is a special URL that opens Slack and takes you directly to the message.
{% endhint %}

Depending on the [**pricing tier**](https://asana.com/pricing) of your Asana organization, the **deep linking** mechanism varies:

* In Asana **Premium** and above, a custom field is created and added to all [**connected**](/streamly/reference/streams/modify/tools.md) Asana Projects and is populated on each Task with the relevant **deep link**.
* In Asana **Basic**, the relevant **deep link** is available at the top of the Task description.