Create a webhook endpoint
Subscribes a URL to events, optionally only for some agent_ids. The response carries the signing secret (Standard Webhooks format) this one time only, so store it; a retry with the same Idempotency-Key returns the endpoint without it. Payloads leave out phone numbers, text and summaries unless you set include_content.
Scopes: webhook:write
Authorizations
An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.
Headers
A unique key (a UUID works) for this request. Retrying with the same key returns the first answer instead of running twice.
255The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.
2026-11-07 "2026-11-07"
Body
The HTTPS URL Kallabot POSTs signed events to.
2048Event types to send (from GET /v1/webhooks/event-types), a whole category such as call.*, or * for everything.
1 - 60 elementsA label for this endpoint.
1 - 120A note for your team.
280Only send events about these agents. Empty sends events about every agent.
50Include conversation content (transcripts, messages, phone numbers) in event payloads. Off by default: events then carry ids you fetch with your API key.
Response
Successful Response
The endpoint id.
Where events are sent.
active or disabled.
The event types (or patterns) it receives.
The last characters of the signing secret.
Send this back as revision on an update.
ISO 8601 time it was created.
ISO 8601 time it last changed.
The endpoint's label.
A note for your team.
Why Kallabot turned it off, when it did.
Only events about these agents; empty is all.
Whether payloads carry conversation content.
The event payload version this endpoint receives.
standard (Standard Webhooks whsec_…) or legacy (rotate it).
When the previous secret stops signing, during a rotation's grace period.
Deliveries failed in a row.
When the current run of failures started.
The last successful delivery.
The signing secret. Only on create and rotate, and never on a replay.