Skip to main content
A webhook endpoint is the account-level resource CallingBox POSTs to whenever a subscribed event fires. Create, update, and delete endpoints via the API or the dashboard.

​
Fields

FieldTypeDescription
iduuidUnique endpoint id.
org_iduuidOwning organization.
urlstringHTTPS URL we POST to. Must be publicly reachable.
descriptionstring | nullHuman-readable label. Optional.
enabled_eventsstring[]Events this endpoint subscribes to. ["*"] matches every event.
statusenabled | disabledWhether the endpoint receives deliveries.
disabled_reasonstring | nullSet when CallingBox auto-disables the endpoint. too_many_failures means 10 consecutive exhausted deliveries.
disabled_attimestamp | nullWhen the endpoint was disabled.
consecutive_failuresintegerConsecutive exhausted deliveries. Resets on any 2xx delivery.
created_attimestamp
updated_attimestamp
signing_secretstringOnly returned on create and rotate_secret. The HMAC key for verifying CallingBox-Signature.

​
Example

{
  "id": "84f2...",
  "org_id": "c3d1...",
  "url": "https://your-server.com/callingbox-webhook",
  "description": "Production CRM sync",
  "enabled_events": ["call.completed", "call.failed"],
  "status": "enabled",
  "disabled_reason": null,
  "disabled_at": null,
  "consecutive_failures": 0,
  "created_at": "2026-04-15T14:00:00Z",
  "updated_at": "2026-04-15T14:00:00Z"
}
See Webhooks for the overall integration flow.