Skip to main content
Subscribe to database events and receive an HTTP POST at your URL instead of polling. To create a subscription, see Create Webhook.

Event types

Payload

Each delivery is a JSON POST body:
The data object varies by event family:

Request headers

Verifying signatures

Every request carries an X-Webhook-Signature header: an HMAC-SHA256 of the payload keyed with your webhook secret (returned once on creation). Verify it before processing:

Delivery, retries & limits

  • Return a 2xx within 30 s to acknowledge; process asynchronously if needed. Use HTTPS.
  • A timeout, network error, 5xx, 408, or 429 is retried up to 2 more times (3 attempts in all) with exponential backoff starting at 5 seconds. Other 4xx responses are not retried.
  • Deduplicate on the event id, because retries reuse it.
  • If the payload would exceed 256 KB, records and previousRecords are dropped and data._truncated is true. recordIds is still complete, so read the records back with the API.