What are the capabilities and restrictions of asana webhook?

English Forum Developers & API
1

I’m currently working with Asana webhooks and trying to understand their full capabilities.

My main concern is:
Do Asana webhooks trigger only when a new task is created,
or
Do they also trigger when an existing task is updated (like custom fields, assignee, description, etc.)?

I want to confirm this to decide how to proceed with our integration. Also, are there any limitations or known restrictions with webhook events that I should be aware of?

Thanks in advance!

2

Hi @Archa_Bajpai1 and welcome to the forum,

FYI I moved your post to the English Forum > Developers & API forum section which is where we discuss programming- and API-related matters.

It’s actually your choice; you can do any of the above depending on the filter parameters you send when you create your webhook.

Specifically:

  • You can use the action parameter within a filter to tell Asana whether you want task creations, updates, or deletions:

The type of change on the resource to pass through the filter. For more information refer to Event.action in the event schema. This can be one of changed , added , removed , deleted , and undeleted depending on the nature of what has occurred on the resource.

  • For the changed action, you can use the fields parameter to obtain webhooks when only certain fields change:

Conditional. A whitelist of fields for events which will pass the filter when the resource is changed. These can be any combination of the fields on the resources themselves. This field is only valid for action of type changed

For more details, see the API docs on webhooks.

There are some; they’re documented at the above link.