# call.escalated: a call was transferred to a person (/api-reference/webhooks/onCallEscalated)

## Webhook callEscalated

Operation ID: `onCallEscalated`
call.escalated: a call was transferred to a person
Sent to webhook endpoints subscribed to this event (or to every event). A webhook URL set on a campaign or an agent receives the fields of `data` at the top level instead, plus `event` (the type) and `timestamp` (Unix seconds), signed with `X-Signature-SHA256` only.

### Parameters

| Name | In | Required | Description |
|---|---|---|---|
| `webhook-id` | header | no | The event id (`evt_…`). Same on every retry and redelivery: use it to drop duplicates. Webhook endpoints only. |
| `webhook-timestamp` | header | no | When this attempt was sent, Unix seconds. Webhook endpoints only. |
| `webhook-signature` | header | no | Space-separated `v1,<base64 signature>` values (two for 24 hours after a secret rotation). Webhook endpoints only. |
| `X-Webhook-Id` | header | no | Same on every retry of this delivery (the event id for webhook endpoints). |
| `X-Webhook-Event` | header | no | The event type, for example `call.completed`. |
| `X-Signature-SHA256` | header | no | Hex HMAC-SHA256 of the raw request body only. On webhook endpoints it is a compatibility header, keyed with the whole `whsec_...` string: it covers neither `webhook-id` nor `webhook-timestamp`, so a captured request can be replayed. Verify `webhook-signature` and reject a `webhook-timestamp` more than 5 minutes from your clock instead. On a campaign or agent webhook URL it is the only signature, keyed with that URL's secret (when one is set); the signed body carries `timestamp`, so reject one more than 5 minutes old. |

### Request body

`application/json` (required)

```json
{
  "properties": {
    "apiVersion": {
      "const": "v1",
      "type": "string"
    },
    "createdAt": {
      "description": "When the event happened, ISO 8601 UTC.",
      "format": "date-time",
      "type": "string"
    },
    "data": {
      "additionalProperties": true,
      "properties": {
        "agentId": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "callId": {
          "format": "uuid",
          "type": "string"
        },
        "campaignId": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "customerNumber": {
          "anyOf": [
            {
              "description": "The number dialled or the caller's number.",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "direction": {
          "enum": [
            "outbound",
            "inbound"
          ],
          "type": "string"
        },
        "endedReason": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "lead": {
          "anyOf": [
            {
              "properties": {
                "company": {
                  "type": "string"
                },
                "customFields": {
                  "additionalProperties": true,
                  "description": "Custom field values (text, numbers, booleans or lists). Sensitive and archived fields are left out.",
                  "properties": {},
                  "type": "object"
                },
                "email": {
                  "type": "string"
                },
                "externalId": {
                  "anyOf": [
                    {
                      "description": "Your ID for this lead, when you sent one.",
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "id": {
                  "format": "uuid",
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "phone": {
                  "type": "string"
                }
              },
              "required": [
                "id"
              ],
              "type": "object"
            },
            {
              "type": "null"
            }
          ]
        },
        "leadId": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "phone": {
          "anyOf": [
            {
              "description": "The lead's phone, or the number dialled when there is no lead.",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "providerCallId": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "transferDialStatus": {
          "anyOf": [
            {
              "description": "The carrier's answer for the transfer leg, when known.",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "transferReason": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "transferStatus": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "transferTarget": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "transferType": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "callId"
      ],
      "type": "object"
    },
    "id": {
      "description": "Event id, `evt_` and 32 hex characters. Same on retries and redeliveries.",
      "type": "string"
    },
    "type": {
      "const": "call.escalated",
      "type": "string"
    }
  },
  "required": [
    "id",
    "type",
    "apiVersion",
    "createdAt",
    "data"
  ],
  "type": "object"
}
```

### Responses

#### 2XX Received. Anything else is retried.
