Need Help Setting Up Webhook or Trigger Events in Asana API

English Forum Developers & API
1

Hi Asana Team,

I’m trying to set up a trigger event (webhook) to receive notifications or updates when certain actions occur in Asana (for example, when a task is created or updated).

Could you please guide me on how to create or use webhooks in Asana? If webhooks are not available for my use case, what alternative methods can I use (apart from Zapier) to get a trigger or event call from Asana?

Any documentation or examples would be really helpful.

2

Hello @e-Roof and welcome to the community!

If you’re exploring ways to receive event-driven notifications from Asana, using webhooks is definitely the right direction. You can find an overview of webhook setup and behavior in this guide.

In short, you can specify:

  • the resource you want to receive events from (e.g., a project),

  • the resource type within that resource (e.g., a task), and

  • the action type you’re interested in (e.g., "added" for task creation events).

Here’s an example of a payload you’d send to the Establish a webhook endpoint if you’d like to be notified when new tasks are created in a specific project:

POST https://app.asana.com/api/1.0/webhooks
{
  "data": {
    "filters": [
      {
        "action": "added",
        "resource_type": "task"
      }
    ],
    "resource": "<PROJECT_GID>",
    "target": "<YOUR_WEBHOOK_ENDPOINT_URL>"
  }
}

The response will include an X-Hook-Secret header containing a secret you can use later to verify events.

The main challenge when working with webhooks is running your own web server to properly receive and process events, including the heartbeat verification events Asana regularly sends to confirm the validity of your webhook URL.

Alternatively, you can consider polling the Get workspace events endpoint periodically and parsing the returned data to identify events you’re interested in.

1 Like