Webhooks allow you to subscribe to events that happen in your Height workspace. When an event gets triggered, we'll send a HTTP POST payload to your configured URL.

Webhooks are useful for setting up integrations, syncing a database with Height tasks, triggering workflows in other services, and more.

Payload

Webhook events payload are formatted in JSON. See more:

The webhook event object

Event types

Webhook event types

Privacy

Webhooks will only send objects that are accessible to all members of a workspace. This means that private tasks will be redacted, and their activities will not be sent.

Event handling

Delivery attempt

A webhook endpoint should return a HTTP status code 2xx if the webhook was correctly handled. This will let us know we shouldn't retry sending the event.

All webhook events are sent through a POST request with a application/json body.

Retry logic

If your server isn't reachable, or isn't returning a correct status code, Height will try resending the webhook again up to 5 times within 3 days.

Order of events

Height doesn't guarantee events will be ordered, and your service should take this into account.

Duplicate events

In the unlikely event we don't receive your endpoint response while sending you a webhook, we may try resending the same webhook event later. Your service should be designed to handle duplicate events from Height webhooks.

Outdated events