My webhooks aren't arriving — how do I debug?
- Topic
- Troubleshooting
- Asked by
- Developers using webhooks
Work through these in order:
Endpoint reachability. Your URL must be publicly reachable over HTTPS and return a 2xx promptly. Slow responses can time out; do heavy work asynchronously after acknowledging.
Signature verification. Atlas signs every webhook. If you compute the signature over the wrong payload (e.g. a re-serialized body instead of the raw bytes) it won't match, and you may be rejecting valid events. Verify against the raw request body.
Delivery logs. The dashboard shows each delivery attempt, the response code, and retries. Failed deliveries are retried with backoff — check there before assuming an event never fired.
Event subscription. Confirm your endpoint is subscribed to the event types you expect.
Log streams. For high-volume debugging, forward events to your own sink via log streams.
See the webhooks guide.
Check that your endpoint returns a 2xx quickly, verify the webhook signature correctly (a signature mismatch looks like a silent failure), and inspect delivery attempts and retries in the dashboard's webhook logs.