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

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

## OpenAPI 3.1 Webhook Specification

```yaml
openapi: 3.1.0
info:
  title: compatibility
  version: 1.0.0
paths: {}
webhooks:
  incoming-call-status-callback:
    post:
      operationId: incoming-call-status-callback
      summary: Incoming call status callback
      description: >-
        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.
      responses:
        '200':
          description: Webhook received successfully
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                CallSid:
                  type: string
                  description: >-
                    A unique identifier for the call. May be used to later
                    retrieve this call from the REST API.
                AccountSid:
                  type: string
                  description: The unique ID of the project this call is associated with.
                From:
                  type: string
                  description: The From number in E.164 format.
                To:
                  type: string
                  description: The To number in E.164 format.
                Timestamp:
                  type: string
                  description: The timestamp of the call creation date/time.
                CallStatus:
                  $ref: >-
                    #/components/schemas/WebhooksIncomingCallStatusCallbackPayloadContentApplicationJsonSchemaCallStatus
                  description: >-
                    The status of the call. For this callback, the value will be
                    either `failed` or `completed`.
                CallDuration:
                  type: string
                  description: The duration, in seconds, of the call.
                AudioInMos:
                  type: string
                  description: >-
                    A mean opinion score on a scale of 1–5 that represents the
                    quality of the call.
              required:
                - CallSid
                - AccountSid
                - From
                - To
                - Timestamp
                - CallStatus
                - CallDuration
                - AudioInMos
components:
  schemas:
    WebhooksIncomingCallStatusCallbackPayloadContentApplicationJsonSchemaCallStatus:
      type: string
      enum:
        - failed
        - completed
      description: >-
        The status of the call. For this callback, the value will be either
        `failed` or `completed`.
      title: >-
        WebhooksIncomingCallStatusCallbackPayloadContentApplicationJsonSchemaCallStatus

```