v37

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0579125452.1 KB

Incoming Phone Numbers

Incoming call status callback

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.

postWebhookincomingCallStatusCallback

Payload

CallSidstring required

A unique identifier for the call. May be used to later retrieve this call from the REST API.

AccountSidstring required

The unique ID of the project this call is associated with.

Fromstring required

The From number in E.164 format.

Tostring required

The To number in E.164 format.

Timestampstring required

The timestamp of the call creation date/time.

CallStatus'failed' | 'completed' required

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

CallDurationstring required

The duration, in seconds, of the call.

AudioInMosstring required

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

Example payload

{
  "CallSid": "b3877c40-da60-4998-90ad-b792e98472ca",
  "AccountSid": "b3877c40-da60-4998-90ad-b792e98472af",
  "From": "+15551234567",
  "To": "+18005559876",
  "Timestamp": "Thu, 04 Apr 2024 18:32:15 +0000",
  "CallStatus": "completed",
  "CallDuration": "142",
  "AudioInMos": "4.5"
}

Response

Webhook received