> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# Incoming call status callback

POST 

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.

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](/docs/platform/webhooks#status-callback-reliability).

Reference: https://signalwire.com/docs/compatibility-api/rest/incoming-phone-numbers/webhooks/incoming-call-status-callback

## Request

### Payload

- `CallSid` (string, required) — A unique identifier for the call. May be used to later retrieve this call from the REST API.
- `AccountSid` (string, required) — The unique ID of the project this call is associated with.
- `From` (string, required) — The From number in E.164 format.
- `To` (string, required) — The To number in E.164 format.
- `Timestamp` (string, required) — The timestamp of the call creation date/time.
- `CallStatus` (enum, required) — The status of the call. For this callback, the value will be either `failed` or `completed`.
  - Allowed values: `failed`, `completed`
- `CallDuration` (string, required) — The duration, in seconds, of the call.
- `AudioInMos` (string, required) — A mean opinion score on a scale of 1–5 that represents the quality of the call.