# The webhook didn't arrive: a troubleshooting guide, and every delivery error explained

- Date: 2026-11-01
- Type: New
- Surface: Developer portal and CLI, Webhooks
- What you need to do: Nothing.
- Address: https://developers.rivr.io/changelog/2026-11-01-webhook-troubleshooting

The new guide The webhook didn't arrive (/guides/webhook-troubleshooting) goes from "nothing came" to a delivery Rivr has given up on: which path the webhook should take (the clinic path via `callbackUrl`, or your organisation's endpoints), whether it was sent at all, why a delivery fails, what to do once Rivr has given up, and how to find the same delivery on both sides with `Rivr-Webhook-Id`. The delivery log on the Webhooks page now explains each error rivr-webhook writes for your organisation's endpoints, with what to do and whether Rivr tries again. In live, a paused endpoint, Rivr's signing key and a timeout used to show as `delivery failed`; each now has its own line, and live still never shows the raw text. The same errors are listed at the end of /events.md and in /events.json under `deliveryErrors`. The guide Receive webhooks now also says that an order an organisation above the clinic creates with its own key does not go to the clinic's address, and that your organisation's endpoints must be https.

