Sample documentation page (fictional product, used by the DocsChat demo)
Troubleshooting
My endpoint does not receive events
- Check that the endpoint URL is HTTPS and publicly reachable. Local URLs such as
localhostdo not work: usenimbus listeninstead. - Open Deliveries and look at the latest attempt. A
0status means a connection or TLS problem; a4xxor5xxstatus comes from your server. - Make sure the endpoint is subscribed to the event type you are sending.
- Confirm the endpoint is not disabled. Endpoints that fail for 3 days in a row are disabled automatically.
Signature verification fails
Use the raw request body, not a parsed and re-serialized one. Check that you are using the signing secret of this specific endpoint (whsec_...), not your API key. Make sure your server clock is correct, because timestamps older than 5 minutes are rejected.
I get 401 Unauthorized
The API key is wrong, deleted, or you are sending a test key to a live resource. Check the Authorization: Bearer header has no extra spaces or quotes.
Duplicate events
Nimbus guarantees at-least-once delivery, so your handler must be idempotent. Use the event id (evt_...) to detect and ignore events you already processed.