Signed eventsRetry enabled

Failed Deliveries

Production-grade webhook documentation for signed event delivery, retries, failed deliveries, event logs, and compliance-safe integrations.

Causes of failed delivery

Common causes

Endpoint timeout

Invalid SSL certificate

DNS failure

401 Unauthorized

403 Forbidden

404 Not Found

500 Server Error

Signature verification failed

Response took too long

How to debug failed events

Inspect event logs for HTTP code, delivery ID, attempts, response body, and next retry. Confirm your endpoint accepts raw JSON and verifies signatures with the correct secret.

Replay events

Manual replay via public API is not available yet. Fix your endpoint, then trigger a new verification to receive a fresh delivery, or contact support for delivery history.

application/json

{  "message": "Manual replay is not available via public API yet.",  "hint": "Fix your endpoint, then trigger a new verification or contact support to replay a delivery."}

Webhook disabling

Repeated failures can disable a webhook endpoint to protect your systems and Xaqiiji delivery infrastructure. Fix the endpoint and manually re-enable it.

Troubleshooting checklist

Fix delivery issues

Confirm endpoint URL is reachable

Verify TLS certificate chain

Check signature secret

Inspect firewall and IP allowlist rules

Return 2xx after storing event

Replay one event after fixing the issue

Retry Logic

Event Logs

Edit this page

Was this page helpful?