Webhooks

Webhooks let your systems react in real time to events that happen on your CELITECH account — like a package crossing a usage threshold — without having to continuously poll the API for changes.

What Are Webhooks

Instead of your systems repeatedly asking "has anything changed?", a webhook lets CELITECH tell you the moment something does. You register an HTTPS endpoint on your own systems, and CELITECH sends an HTTP POST request to that endpoint whenever a subscribed event occurs.

This is especially useful for consumption alerts: rather than polling Get Purchase Consumption on a timer for every active purchase, you can be notified the instant a package crosses a usage threshold and only look up details when it matters.

How It Works

1. An event occurs — for example, an eSIM's data usage crosses 50% of its package's data limit.
2. CELITECH sends a POST request to the endpoint URL you've configured, with a JSON body describing the event.
3. You verify the request using the signature included in its headers, so you can trust it actually came from CELITECH. See Verifying Webhook Signatures.
4. Your endpoint responds with a 2xx status code to acknowledge receipt. If it doesn't, CELITECH retries the delivery automatically. See Delivery & Retries.

What's Available Today

See the Event Catalog for the current list of available events. More events will be added over time — check the Changelog for updates.

note

Webhook access is currently enabled per account on request, not self-service. See Requesting Webhook Access to get started.

Where to Go Next

• Access & Setup — how to request access and register your endpoint
• Event Catalog — every event type and its payload
• Verifying Webhook Signatures — how to confirm a request really came from CELITECH