Webhook Overview

Webhooks provide the ability to receive real-time data updates about various platform events. When a registered event occurs, the system sends a snapshot of the entity that changed to the configured endpoint URL.

Webhook Schema

FieldDescriptionType
idUnique identifier (UUID)String
nameDescriptive name for this webhook configurationString
urlTarget URL endpoint where webhook notifications will be sentString
entityType of entity to monitor for events (e.g., bill, order, billing)String
eventsArray of specific events to trigger webhook notifications for this entityArray
paramsAdditional parameters or configuration options for the webhookObject
verbHTTP method used for webhook requests (e.g., POST, PUT)String
created_atIndicates when the record was created in ISO8601 formatString
updated_atIndicates when the record was last updated in ISO8601 formatString

Entity and events

EntityEvents
billpending, paid, canceled
ordercanceled, in_progress, finished
billingwaiting_payment, active, finished, canceled