---
title: "Call Conversation Ended"
method: POST
path: "callConversationEnded"
tags: ["Callbacks"]
---

# Call Conversation Ended

`POST callConversationEnded` (webhook)

This webhook uses Telnyx headers (telnyx-timestamp, telnyx-signature-ed25519) that are compatible with Standard Webhooks specification for SDK generation. Custom validation logic can map these to standard webhook-timestamp and webhook-signature equivalents. See https://github.com/standard-webhooks/standard-webhooks for details.

## Headers

- `telnyx-timestamp` integer, required — Unix timestamp for replay attack prevention
- `telnyx-signature-ed25519` string, required — Ed25519 signature of timestamp|payload for verification

## Payload

- CallConversationEndedEvent
  - `data` CallConversationEnded
    - `created_at` string, date-time — Timestamp when the event was created in the system.
    - `event_type` 'call.conversation.ended' — The type of event being delivered.
    - `id` string, uuid — Unique identifier for the event.
    - `occurred_at` string, date-time — ISO 8601 datetime of when the event occurred.
    - `payload` object
      - `assistant_id` string — Unique identifier of the assistant involved in the call.
      - `call_control_id` string — Call ID used to issue commands via Call Control API.
      - `call_leg_id` string — ID that is unique to the call leg.
      - `call_session_id` string — ID that is unique to the call session (group of related call legs).
      - `calling_party_type` 'pstn' | 'sip' — The type of calling party connection.
      - `client_state` string — Base64-encoded state received from a command.
      - `connection_id` string — Call Control App ID (formerly Telnyx connection ID) used in the call.
      - `conversation_id` string — ID unique to the conversation or insight group generated for the call.
      - `duration_sec` integer — Duration of the conversation in seconds.
      - `from` string — The caller's number or identifier.
      - `llm_model` string — The large language model used during the conversation.
      - `reason` string, nullable — Reason the conversation ended. For Conversation Relay, `customer_disconnect` indicates that the customer WebSocket disconnected.
      - `stt_model` string — The speech-to-text model used in the conversation.
      - `to` string — The callee's number or SIP address.
      - `tts_model_id` string — The model ID used for text-to-speech synthesis.
      - `tts_provider` string — The text-to-speech provider used in the call.
      - `tts_voice_id` string — Voice ID used for TTS.
    - `record_type` 'event' — Identifies the type of the resource.

## Acknowledgement `200`

The server must return an HTTP 200, otherwise we will reattempt delivery at the failover webhook URL.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/3fdc16374d70/schema)