For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Log inSign up
Support
cXMLREST API
cXMLREST API
  • Core
    • Overview
    • Authorization
    • Error codes
    • Paging
    • REST client SDKs
  • Compatibility REST API
        • POSTIncoming call status callback
      • GETList all Incoming Phone Numbers
      • POSTCreate an Incoming Phone Number
      • GETRetrieve an incoming phone number
      • POSTUpdate an incoming phone number
      • DELDelete an incoming phone number
LogoLogoSignalWire Docs
Log inSign up
Support
Compatibility REST APIIncoming Phone NumbersWebhooks

Incoming call status callback

|View as Markdown|Open in Claude|
Payload
1{
2 "CallSid": "b3877c40-da60-4998-90ad-b792e98472ca",
3 "AccountSid": "b3877c40-da60-4998-90ad-b792e98472af",
4 "From": "+15551234567",
5 "To": "+18005559876",
6 "Timestamp": "Thu, 04 Apr 2024 18:32:15 +0000",
7 "CallStatus": "completed",
8 "CallDuration": "142",
9 "AudioInMos": "4.5"
10}
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](/docs/compatibility-api/rest/incoming-phone-numbers/create-incoming-phone-number) or [update](/docs/compatibility-api/rest/incoming-phone-numbers/update-incoming-phone-number) 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.
Was this page helpful?
Previous

List all Incoming Phone Numbers

Next
Built with

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.

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