Skip to main content
Webhooks deliver events from Spirii to a URL you control, so you can react to things like a charging session starting, a CDR being finalized, or a token being disabled — without polling.

​
How it works

1

Register an endpoint

Tell us the URL we should POST events to.
2

Subscribe to event types

Pick which event types should fire (e.g., session.started, cdr.finalized).
3

Verify and process

Verify the signature on each delivery, then act on the event.

​
Delivery semantics

  • At-least-once: a single event may be delivered more than once. Make handlers idempotent.
  • Retries: failed deliveries are retried with exponential backoff for up to 24 hours.
  • Ordering: events for the same resource are delivered in order on a best-effort basis.