zulip/templates/zerver/integrations/asana.md

Get Zulip notifications for your Asana projects via Zapier!

1.  {!create-stream.md!}

1.  Next, on your {{ settings_html|safe }}, create a bot for Asana.
    Construct the URL for the Asana bot using the bot API key and
    stream name, like so:

    `{{ api_url }}/v1/external/zapier?api_key=abcdefgh&stream=asana`

1.  Start by setting up a [Zapier](https://zapier.com/) account.

1.  Next, create a ZAP, picking Asana as the app you'd like
    to receive notifications from as the **Trigger (Step 1)**:

    ![Trigger](/static/images/integrations/asana/001.png)

1.  Next, select the Asana event that you'd like to receive notifications
    for (**Choose Trigger**), such as when you add a new **Task** in
    an Asana project:

    ![Trigger selection](/static/images/integrations/asana/002.png)

1.  Next, click on **Connect a New Account** and follow the steps
    to connect your Asana account to the Zap:

    ![Account selection](/static/images/integrations/asana/003.png)

1.  Select the Asana project you'd like to receive notifications for:

    ![Project selection](/static/images/integrations/asana/004.png)

1.  In **Action (Step 2)**, select **Webhooks by Zapier** as the app:

    ![App selection](/static/images/integrations/asana/005.png)

    and `POST` as the action:

    ![Action selection](/static/images/integrations/asana/006.png)

1.  Configure **Set up Webhooks by Zapier POST** as follows:

     * `URL` is the URL we created above.
     * `Payload Type` set to `JSON`.

1.  Finally, configure **Data**. You have to add 2 fields:

     * `subject` is the field corresponding to the subject of the message.
     * `content` is the field corresponding to the content of the message.

1.  You can format the content of the `content` and `subject` fields
    in a number of ways as per your requirements.

    Here's an example configuration:

    ![Example configuration](/static/images/integrations/asana/007.png)

{!congrats.md!}

![Asana bot message](/static/images/integrations/asana/008.png)

You can repeat the above process and create Zaps for different projects
and/or different kinds of Asana events that you'd like to be notified
about in Zulip.