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

# Create Asana Notification

## Introduction

When working in a team it is crucial to know what needs to be done and what is being worked on. **Asana** is such a tool that allows to create tasks for each member of the team and colleagues can collaborate on them.

We integrated [Asana](https://asana.com/) into **Amber Signals** so you can integrate important information from outside of your company into the workflow. This allows you to have actionable tasks right away.

## Create Asana Channel

Creating the Asana integration is very simple, but we need two very important information:

1. API Key
2. Project ID

The **API Key** allows us to create tasks for you and the **Project ID** knows where the tasks should be created.

### Creating Asana API Key

In Asana it is called a **Personal access token** or PAT and we need to create one. Open <https://app.asana.com/0/my-apps> and click **Create new token**.

<figure><img src="/files/eSoGU8oGv4MBUNh6hXEE" alt=""><figcaption><p>Create new token on Asana</p></figcaption></figure>

Give it a good description (e.g. Amber Signals) so you can remember where it is used. Copy the token, we need it later in the [Dashboard](https://ambersignals.com/dashboard).

### Finding Asana Project ID

This seems to be a bit more complicated, but we have a screenshot for you. We need to copy the project id from the url when you have the project open.

Open a new browser tab and open the project. In the browser bar you see a url with two long ids. The first id is the Project ID. Copy that one for later.

<figure><img src="/files/riYMb3ZNzZTm86SesSKV" alt=""><figcaption><p>Asana Project ID</p></figcaption></figure>

In our example the project id is the one with the red underline.

## Create Asana Channel

Open our [Dashboard](https://ambersignals.com/dashboard) and click **Asana** to create a new channel.

<figure><img src="/files/eHMrfsWq0JC3ZYe6Adqd" alt=""><figcaption><p>Create Asana Channel</p></figcaption></figure>

Choose a **Description** that reminds you to which project the tasks will be created, The **Project ID** is the first number from the URL when you have the Asana project open and the **API Key** is the PAT we created earlier.\
Once added we will create new tasks when a notification is triggered.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ambersignals.com/tutorials/create-asana-notification.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
