---
title: "Call Initiated"
method: POST
path: "callInitiated"
tags: ["Callbacks"]
---

# Call Initiated

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

- CallInitiatedEvent
  - `data` CallInitiated
    - `record_type` 'event' — Identifies the type of the resource.
    - `event_type` 'call.initiated' — 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_control_id` string — Call ID used to issue commands via Call Control API.
      - `connection_id` string — Call Control App ID (formerly Telnyx connection ID) used in the call.
      - `connection_codecs` string — The list of comma-separated codecs enabled for the connection.
      - `offered_codecs` string — The list of comma-separated codecs offered by caller.
      - `call_leg_id` string — ID that is unique to the call and can be used to correlate webhook events.
      - `custom_headers` CustomSipHeader[] — Custom headers from sip invite
        - `name` string, required — The name of the header to add.
        - `value` string, required — The value of the header.
      - `sip_headers` InboundSipHeader[] — User-to-User and Diversion headers from sip invite.
        - `name` 'User-to-User' | 'Diversion', required — The name of the header received from the SIP INVITE.
        - `value` string, required — The value of the header.
      - `shaken_stir_attestation` string — SHAKEN/STIR attestation level.
      - `shaken_stir_validated` boolean — Whether attestation was successfully validated or not.
      - `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.
      - `client_state` string — State received from a command.
      - `caller_id_name` string — Caller id.
      - `call_screening_result` string — Call screening result.
      - `from` string — Number or SIP URI placing the call.
      - `to` string — Destination number or SIP URI of the call.
      - `direction` 'incoming' | 'outgoing' — Whether the call is `incoming` or `outgoing`.
      - `state` 'parked' | 'bridging' — State received from a command.
      - `start_time` string, date-time — ISO 8601 datetime of when the call started.
      - `tags` string[] — Array of tags associated to number.

## 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/versions/8f5f4e537994/schema)