Event types
Payload
Each delivery is a JSON POST body:
The
data object varies by event family:
Request headers
Verifying signatures
Every request carries anX-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, or429is retried up to 2 more times (3 attempts in all) with exponential backoff starting at 5 seconds. Other4xxresponses are not retried. - Deduplicate on the event
id, because retries reuse it. - If the payload would exceed 256 KB,
recordsandpreviousRecordsare dropped anddata._truncatedistrue.recordIdsis still complete, so read the records back with the API.