Skip to navigation

Incoming call status callback

View as MarkdownOpen in Claude

Payload sent by SignalWire to your Inbound Call Status Callback URL for inbound calls to a phone number.

Configure StatusCallback at the phone number level via the dashboard (Phone Numbers → select a number → Phone Number Settings) or programmatically via the create or update Incoming Phone Number API endpoints.

By default, the webhook fires only when the call is completed or failed, making it well-suited for tracking inbound call success rate, call quality, and total call volume in a call center context.

Status callbacks are advisory, best-effort notifications — delivery can be delayed or fail silently, so don’t gate time-critical actions on receiving one. See Status callback reliability.

Payload

The payload of this webhook request is an object.
CallSidstringRequired
A unique identifier for the call. May be used to later retrieve this call from the REST API.
AccountSidstringRequired
The unique ID of the project this call is associated with.
FromstringRequired
The From number in E.164 format.
TostringRequired
The To number in E.164 format.
TimestampstringRequired

The timestamp of the call creation date/time.

CallStatusenumRequired

The status of the call. For this callback, the value will be either failed or completed.

Allowed values:
CallDurationstringRequired
The duration, in seconds, of the call.
AudioInMosstringRequired

A mean opinion score on a scale of 1–5 that represents the quality of the call.

Response

200
Webhook received