POST requests. Each
request carries one event in a JSON envelope. To set up a webhook and check its signature, see
Receive events with webhooks.
Request
Headers
A receiver accepts a request when one of the signatures matches and the timestamp is within 300
seconds of its clock. See Verify the signature.
Envelope
Every event has the same envelope.The event’s ID, starting with
evt_. It stays the same on every retry and every resend. Use it to
skip events you’ve already handled.When the event happened, in ISO 8601 UTC, such as
2026-10-15T14:03:22.114Z. Events can arrive
out of order: sort by this field.Delivery
Events never carry a transcript, a recording or a secret.
call.started
Sent when a call reaches an application, inbound or outbound. If the call goes to the application’s fallback,appRef is the application that answered.
The call’s ref. The same ref names its call record.
call.ended
Sent when a call that reached an application ends. A call that sentcall.started sends
call.ended.
The call’s length in seconds, rounded. After a cold transfer, it counts until the transferred
call ends.
call.failed
Sent when a call never reaches an application: the number you called was busy or didn’t answer, the call was rejected, or neither the application nor its fallback could be reached. A failed call sends nocall.started or call.ended.
Why the call failed. Common values are below; treat any other value as a generic failure.
call_record.sealed
Sent each time a new version of a call record is sealed. Version1 is
sealed after the call ends. Later versions come from changes, such as a part being deleted. No event is sent
when a record is erased.
Where to fetch that version:
/api/records/<callRef>?version=<version>, relative to the API’s
host. An operator can set a different base. Fetch it with your access token.provider.deprecated
Sent once to each workspace that names the item in a saved application or agent, when Fonoster deprecates a provider, model or voice. See Providers and models.Retired events
The 0.27 AutopiloteventsHook events are gone. Creating a webhook with one of their names is
refused with the replacement.