Webhooks

Receive real-time notifications for usage-based billing events via webhooks.

Available Events

EventDescription
meter.createdA new meter was created.
usage_event.receivedA usage event was successfully ingested.
alert.triggeredA usage alert threshold was exceeded.
credit_grant.createdCredits were issued to a customer.
credit_grant.depletedA customer's credit balance reached zero.

Webhook Payloads

All UBB webhook payloads include:

  • event_type — the event identifier
  • data — the resource object (meter, alert, credit grant)
  • created_at — when the event occurred
  • customer_id — the affected customer (where applicable)