---
title: "Call Recording Saved"
method: POST
path: "callRecordingSaved"
tags: ["Callbacks"]
---

# Call Recording Saved

`POST callRecordingSaved` (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

- CallRecordingSavedEvent
  - `data` CallRecordingSaved
    - `event_type` 'call.recording.saved' — The type of event being delivered.
    - `id` string, uuid — Identifies the type of resource.
    - `occurred_at` string, date-time — ISO 8601 datetime of when the event occurred.
    - `payload` object
      - `call_leg_id` string — ID that is unique to the call and can be used to correlate webhook events.
      - `call_session_id` string — ID that is unique to the call session and can be used to correlate webhook events. Call session is a group of related call legs that logically belong to the same phone call, e.g. an inbound and outbound leg of a transferred call.
      - `channels` 'single' | 'dual' — Whether recording was recorded in `single` or `dual` channel.
      - `client_state` string — State received from a command.
      - `connection_id` string — Call Control App ID (formerly Telnyx connection ID) used in the call.
      - `public_recording_urls` object — Recording URLs in requested format. The URL is valid for as long as the file exists. For security purposes, this feature is activated on a per request basis. Please contact customer support with your Account ID to request activation.
        - `mp3` string, nullable — Recording URL in requested `mp3` format.
        - `wav` string, nullable — Recording URL in requested `wav` format.
      - `recording_ended_at` string, date-time — ISO 8601 datetime of when recording ended.
      - `recording_started_at` string, date-time — ISO 8601 datetime of when recording started.
      - `recording_urls` object — Recording URLs in requested format. These URLs are valid for 10 minutes. After 10 minutes, you may retrieve recordings via API using Reports -> Call Recordings documentation, or via Mission Control under Reporting -> Recordings.
        - `mp3` string, nullable — Recording URL in requested `mp3` format.
        - `wav` string, nullable — Recording URL in requested `wav` format.
    - `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/ec31f78cf002/schema)