Debugging
Webhook errors
These pages are for a failure you are already looking at. For the inspect-then-localhost walkthrough, see How to test webhooks. For a handler in a specific stack, see webhook localhost by framework.
Inspect the request Connect localhost
Pick the symptom
SignatureWebhook signature verification failedHMAC or secret-token check failed on bytes your handler hashed.HTTP 400Webhook 400Handler or dashboard shows 400 Bad Request.HTTP 404Webhook 404POST reached a host that has no matching route.HTTP 500Webhook 500Handler threw or returned 500 after accepting the POST.TimeoutWebhook timeoutProvider gave up waiting before a 2xx arrived.MissingWebhook not receivedProvider dashboard or app logs show no delivery.DuplicateDuplicate webhookSame event processed more than once; Mercur does not retry.HTTP 502Webhook 502 localhostRelay connected; local process refused the port.