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.