Asana · AsyncAPI Specification

Asana Webhooks Events API

Version 1.0

The Asana Webhooks Events API delivers real-time event notifications to your application when changes occur on Asana resources. Webhooks use HTTP POST to deliver events to a target URL you configure. Events are delivered within a minute on average using an at-most-once delivery system. Establishing a webhook requires a two-part handshake process. When a webhook is created, Asana sends a test POST to the target URL with an X-Hook-Secret header. The target must respond with a 200 OK or 204 No Content and echo back the X-Hook-Secret header to confirm the subscription. Subsequent event deliveries include an X-Hook-Signature header containing an HMAC-SHA256 signature of the request body using the X-Hook-Secret as the key, which can be used to verify event authenticity.

View Spec View on GitHub CollaborationProductivityProject ManagementProjectsTask ManagementTasksWorkflowAsyncAPIWebhooksEvents

Channels

/webhooks/events

subscribe receiveWebhookEvents

Receive webhook events

Channel for receiving Asana webhook events. Events are delivered as HTTP POST requests to the target URL configured when the webhook was created. Events bubble up from child resources (e.g., subscribing to a project will include events for tasks within that project).

Messages

✉

WebhookHandshake

Webhook Confirmation Handshake

Initial handshake request sent by Asana when a webhook is created. The target must respond with a 200 OK and echo back the X-Hook-Secret.

✉

WebhookEvent

Webhook Event Delivery

An event delivery containing one or more change events on Asana resources.

Servers

http

production https://app.asana.com/api/1.0

Asana sends webhook events via HTTP POST to your configured target URL. You configure the target URL when establishing a webhook via the REST API.