> 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

### [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" %}
![](/files/-M9g--eBLOc8l4iWrGz0)
{% endtab %}

{% tab title="Step 2" %}
![](/files/-M9g3U9EVpeL6XhaR8kg)
{% endtab %}

{% tab title="Step 3 (new project)" %}
![](/files/-M9g3lOtjE9SBt176cy5)
{% endtab %}

{% tab title="Step 3 (existing project)" %}
![](/files/-M9g5EtUO6VuABN99LCq)
{% endtab %}
{% endtabs %}