> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apten.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Call Dispositioned

> Get notified when a completed voice call is assigned a disposition.

The `call.dispositioned` webhook event is triggered when Apten assigns a disposition to a completed voice call. Use it to send call outcomes to your CRM, trigger follow-up workflows, or report on the categories you define in [Call Dispositions](/tutorials/call_dispositions).

<Note>
  This event is emitted when a call first receives a disposition. It is separate from `call.completed`, which is sent when the call finishes.
</Note>

## Payload

```json theme={null}
{
  "event": "call.dispositioned",
  "data": {
    "leadId": "c4f23a1b-d8e5-4f67-90c1-2a5b8d3e9x7y",
    "externalLeadId": "003XX000004DHPY",
    "phone": "+12025550189",
    "profile": "Default Profile",
    "callId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "durationSeconds": 145,
    "direction": "OUTBOUND",
    "summary": "The lead requested a follow-up appointment.",
    "midCallTransfer": false,
    "isTransfer": false,
    "dispositionId": "d9e8f7a6-b5c4-3210-fedc-ba9876543210",
    "dispositionName": "Appointment Requested",
    "dispositionClassifiedAt": "2026-08-24T17:30:00Z"
  },
  "timestamp": "2026-08-24T17:30:01Z"
}
```

## Properties

| Property                       | Type                 | Description                                                        |
| ------------------------------ | -------------------- | ------------------------------------------------------------------ |
| `event`                        | string               | The webhook event type (`call.dispositioned`).                     |
| `data.leadId`                  | string               | The unique identifier for the lead.                                |
| `data.externalLeadId`          | string \| undefined  | The CRM lead ID, when the lead is associated with a supported CRM. |
| `data.close_crm_leadId`        | string \| undefined  | The Close CRM lead ID, when the lead is associated with Close CRM. |
| `data.phone`                   | string               | The phone number of the lead.                                      |
| `data.profile`                 | string               | The customer profile assigned to the lead.                         |
| `data.callId`                  | string               | The unique identifier for the classified call.                     |
| `data.durationSeconds`         | number               | The duration of the call in seconds.                               |
| `data.direction`               | string               | The call direction: `INBOUND` or `OUTBOUND`.                       |
| `data.summary`                 | string \| undefined  | Optional summary of the call conversation.                         |
| `data.midCallTransfer`         | boolean \| undefined | Whether a transfer occurred during the call.                       |
| `data.isTransfer`              | boolean \| undefined | Whether the call is a transfer call.                               |
| `data.dispositionId`           | string               | The unique identifier of the applied disposition.                  |
| `data.dispositionName`         | string \| undefined  | The configured name of the applied disposition.                    |
| `data.dispositionClassifiedAt` | string \| undefined  | The ISO 8601 timestamp when Apten classified the call.             |
| `timestamp`                    | string               | The ISO 8601 timestamp when Apten sent the webhook.                |

## Fetching Full Call Details

Use `callId` to retrieve the call transcript, summary, and transfer metadata with [`GET /calls/{callId}`](/api-reference/calls/get-call).