Sample documentation page (fictional product, used by the DocsChat demo)

Troubleshooting

My endpoint does not receive events

  1. Check that the endpoint URL is HTTPS and publicly reachable. Local URLs such as localhost do not work: use nimbus listen instead.
  2. Open Deliveries and look at the latest attempt. A 0 status means a connection or TLS problem; a 4xx or 5xx status comes from your server.
  3. Make sure the endpoint is subscribed to the event type you are sending.
  4. 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.