---
title: "Incoming call status callback"
method: POST
path: "incomingCallStatusCallback"
tags: ["Incoming Phone Numbers"]
---

# Incoming call status callback

`POST incomingCallStatusCallback` (webhook)

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).

## Payload

- object — 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).
  - `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` 'failed' | 'completed', required — The status of the call. For this callback, the value will be either `failed` or `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.

## Acknowledgement `200`

Webhook received

---

[API](https://skmtc.net/signalwire/apis/compatibility-api.md) · [All operations](https://skmtc.net/signalwire/apis/compatibility-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signalwire/compatibility-api/revisions/e6faba43acd7/schema)