# call.failed: a call ended without connecting (/api-reference/webhooks/onCallFailed)

## Webhook callFailed

Operation ID: `onCallFailed`
call.failed: a call ended without connecting
Sent to webhook endpoints subscribed to this event (or to every event).

### 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"
            }
          ]
        },
        "callAnalysis": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ]
        },
        "callId": {
          "format": "uuid",
          "type": "string"
        },
        "campaignId": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "crmPayload": {
          "anyOf": [
            {
              "additionalProperties": true,
              "description": "Everything the call stored for your CRM, including callAnalysis and transfer details.",
              "properties": {},
              "type": "object"
            },
            {
              "type": "null"
            }
          ]
        },
        "customerNumber": {
          "anyOf": [
            {
              "description": "The number dialled or the caller's number.",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "direction": {
          "enum": [
            "outbound",
            "inbound"
          ],
          "type": "string"
        },
        "duration": {
          "anyOf": [
            {
              "description": "Seconds.",
              "type": "number"
            },
            {
              "type": "null"
            }
          ]
        },
        "endTime": {
          "anyOf": [
            {
              "description": "ISO 8601 timestamp, UTC.",
              "format": "date-time",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "endedReason": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "extractedFields": {
          "additionalProperties": true,
          "type": "object"
        },
        "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"
            }
          ]
        },
        "merchantOutcome": {
          "description": "Outcome of the lead's or call's latest result.",
          "enum": [
            "qualified",
            "interested",
            "callback",
            "not_interested",
            "no_response",
            "no_answer",
            "busy",
            "call_failed",
            "voicemail",
            ""
          ],
          "type": "string"
        },
        "outcome": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "outcomeCategory": {
          "anyOf": [
            {
              "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"
            }
          ]
        },
        "recommendedLeadStatus": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "recordingUrl": {
          "anyOf": [
            {
              "description": "Fetch with your `X-API-Key`.",
              "format": "uri",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "sentiment": {
          "anyOf": [
            {
              "enum": [
                "positive",
                "neutral",
                "negative"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "startTime": {
          "anyOf": [
            {
              "description": "ISO 8601 timestamp, UTC.",
              "format": "date-time",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "status": {
          "description": "Final call status, for example `completed`, `no_answer`, `busy` or `failed`.",
          "type": "string"
        },
        "summary": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "transcript": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "callId",
        "status"
      ],
      "type": "object"
    },
    "id": {
      "description": "Event id, `evt_` and 32 hex characters. Same on retries and redeliveries.",
      "type": "string"
    },
    "type": {
      "const": "call.failed",
      "type": "string"
    }
  },
  "required": [
    "id",
    "type",
    "apiVersion",
    "createdAt",
    "data"
  ],
  "type": "object"
}
```

### Responses

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