Call Dispositioned - Apten

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.

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

Payload

{
  "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}.