Webhooks
Webhook troubleshooting
Why a webhook did not arrive, and what to check.
Nothing arrives
- Check the destination is switched on in Settings, Webhooks and set to hear the event.
- The address must be https and public; private and local addresses are refused.
- Look at the destination's recent deliveries for the status your server answered.
Repeated deliveries
A delivery that did not get a 2xx answer within 10 seconds is retried after 1, 5 and 30 minutes. Answer quickly with a 2xx and do slow work afterwards; skip events whose idempotency_key you have already handled.
Signatures do not match
Compute the HMAC over the raw body exactly as received. Re-serialised JSON changes spacing and order and breaks the signature. Check you are using the secret of the destination that received the request.