> 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/streams/modify/tools/asana.md).

# Asana

Integration component: Projects

### [Streams](/streamly/concepts/stream.md) **can been connected to new or existing** [**Projects**](https://asana.com/guide/help/projects/basics) **in** [**Asana**](https://asana.com)**.**

#### `Step 1`

In the **first modal**, select the Asana [**`Workspace`**](https://asana.com/guide/help/workspaces/basics) you would like to use.

{% hint style="info" %}
You must enter **at** **least two characters** in all dynamic select menus.
{% endhint %}

{% hint style="warning" %}
To populate this menu for the **first time**, the app will need to query your Asana instance and build a list of options, this can take **several seconds** to complete.

Once a cache of options has been built, this menu will populate immediately, but refreshes (if the desired `Workspace` is newly created) will also take **several seconds** to complete.
{% endhint %}

#### `Step 2`

In the **second modal**, choose either a **new** or an **existing** Asana **`Project`** for the connection.

#### `Step 3`

* If connecting a **new** Asana **`Project`**, select the Asana [**`Team`**](https://developers.asana.com/docs/teams) where it will be created and then name the new Project.  
* If connecting to an **existing** Asana **`Project`**, select it from the menu.

#### The tool connection will be shown where Streams are mentioned in Slack and in [**Requests**](/streamly/concepts/request.md) **that generated corresponding tasks in Asana.**

{% tabs %}
{% tab title="Step 1" %}
![](https://515986723-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M8LPwlH5mb9FAOH85oP%2F-M9fw1Fi5ywJqZUgGou4%2F-M9g--eBLOc8l4iWrGz0%2Fimage.png?alt=media\&token=c8c42648-05ac-4c5a-b0b3-176633e564c5)
{% endtab %}

{% tab title="Step 2" %}
![](https://515986723-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M8LPwlH5mb9FAOH85oP%2F-M9fw1Fi5ywJqZUgGou4%2F-M9g3U9EVpeL6XhaR8kg%2Fimage.png?alt=media\&token=edf7d7e5-f1f4-42d0-be8d-4eff9e7ecee1)
{% endtab %}

{% tab title="Step 3 (new project)" %}
![](https://515986723-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M8LPwlH5mb9FAOH85oP%2F-M9fw1Fi5ywJqZUgGou4%2F-M9g3lOtjE9SBt176cy5%2Fimage.png?alt=media\&token=4418175b-7e1a-4066-baa9-64db6cdde127)
{% endtab %}

{% tab title="Step 3 (existing project)" %}
![](https://515986723-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M8LPwlH5mb9FAOH85oP%2F-M9g3quUj-Zsk0WUZwdM%2F-M9g5EtUO6VuABN99LCq%2Fimage.png?alt=media\&token=0bbb26ba-942c-488c-8cc6-60be4a527927)
{% endtab %}
{% endtabs %}