Skip to main content

Overview

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.

note

Webhook access is enabled per account on request, not self-service. To get started, contact devops@celitech.com or your CELITECH account manager and ask to have webhooks enabled for your account.

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 Signature Verification.
  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.

Next Steps​