Endpoint verification

postWebhookendpointVerification

Payload

event'endpoint.verification' required
delivery_idstring required
sent_atstring date-time required
testtrue required

Always true, so a handler that answers test events with a 2xx passes unchanged.

Response

Any 2xx verifies the endpoint. It is never retried, apart from one resend signed with the other environment's secret after a 4xx or 5xx.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.