Call Completed

The call.completed webhook event is triggered when an AI call or transfer call is completed. This can be used to track call duration, direction, and capture call summaries for reporting and analytics. For transfer calls, Apten sends this event after the transfer outcome is settled. The optional data.transfer object contains the final result, so integrations do not need to combine multiple transfer webhooks for the final call state.

Payload

{
  "event": "call.completed",
  "data": {
    "leadId": "c4f23a1b-d8e5-4f67-90c1-2a5b8d3e9x7y",
    "externalLeadId": "003XX000004DHPY",
    "phone": "+12025550189",
    "profile": "Default Profile",
    "callId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "durationSeconds": 145,
    "direction": "INBOUND",
    "summary": "Customer inquired about pricing and requested a follow-up meeting.",
    "isTransfer": false,
    "midCallTransfer": true,
    "transfer": {
      "status": "connected",
      "type": "WARM",
      "transferNumber": "+14153750579",
      "durationSeconds": 120
    }
  },
  "timestamp": "2024-01-15T14:30:00Z"
}

Properties

Property	Type	Description
`event`	string	The webhook event type (`call.completed`).
`data.leadId`	string	The unique identifier for the lead.
`data.externalLeadId`	string	The CRM lead ID (Salesforce, HubSpot, or 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 completed 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.isTransfer`	boolean \| undefined	Whether this is a direct transfer call.
`data.midCallTransfer`	boolean \| undefined	Whether the AI call transferred the lead mid-conversation.
`data.transfer`	object \| undefined	Final transfer outcome. Omitted for non-transfer calls or when no transfer was initiated.
`data.transfer.status`	string	The final transfer status: `connected` or `failed`.
`data.transfer.type`	string	The transfer type: `WARM` or `COLD`.
`data.transfer.transferNumber`	string \| undefined	The number used for the transfer, when available.
`data.transfer.durationSeconds`	number \| undefined	Duration of the transfer portion of the call.
`data.transfer.failureCode`	string \| undefined	Failure reason: `agent_not_connected` or `lead_disconnected`.
`timestamp`	string	The ISO 8601 timestamp when the call was completed.

Fetching full call details

This webhook includes the final transfer outcome when the call involved a transfer. Use GET /calls/{callId} when you also need the full transcript or additional call metadata.

Downloading a recording

Use data.callId with GET /calls/{callId}/recording to request a temporary download URL. A recording may not be ready when this webhook arrives. If the endpoint returns 409 Recording is not ready yet., wait and retry the request. Download the recording file immediately and store the file in your own system. Do not store or reuse the temporary URL; request a new one if it expires.

Get Started

Account & Security

Tutorials

Compliance

Webhooks

Integrations

Webchat

Automations

Call Completed

Payload

Properties

Fetching full call details

Downloading a recording

​Payload

​Properties

​Fetching full call details

​Downloading a recording

Payload

Properties

Fetching full call details

Downloading a recording