API reference
Webhooks

Webhooks

Receive real-time events from KushRouter for request lifecycle and batches.

Events

  • request.completed
  • request.failed
  • batch.completed (when using Batches)

Configure

  • Create a webhook endpoint in your app that accepts POST JSON.
  • Set your webhook URL and secret in the dashboard.
  • We recommend verifying signatures and retrying with idempotency.

Delivery

  • Method: POST
  • Content-Type: application/json
  • Retries: Exponential backoff on non-2xx responses (limited attempts)
  • Ordering: Not guaranteed across different resources; rely on ids and timestamps

Security and signature verification

Every delivery includes headers for HMAC verification.

Example payloads

See request.completed, request.failed, and batch.completed examples in the original Operations doc.

See also