Delivery envelope
Webhook bodies identify the event and changed resource. They do not embed the resource’s current state:- Verify the signature against the exact raw body.
- Deduplicate by
eventId. - Route handling by
event. - Use
entityIdto retrieve the resource’s current state when a corresponding GET endpoint is available.
Signature verification
Every delivery includesslash-webhook-signature. Verify its base64 value with
SHA-256 over the raw request body and either public RSA key.
Deliveries use the current key through October 4, 2026 and the new key starting
October 5, 2026, so a signature that matches either key is valid during the
transition. Do not verify a parsed and re-serialized JSON body.