Telnyx Webhooks

generated: '2026-10-08'
method: derived
generator: derive-webhooks.py
source:
- openapi/telnyx-callbacks-api-openapi.yml
- openapi/telnyx-texml-rest-commands-api-openapi.yml
description: 'Event surface derived from the provider''s own OpenAPI: webhooks, enum StatusCallbackEvent. No AsyncAPI
  document is published by the provider; this catalog lists the events the contract names.'
management_operations:
- ListNotificationChannels
- CreateNotificationChannels
- DeleteNotificationChannel
- GetNotificationChannel
- UpdateNotificationChannel
- FindNotificationsEventsConditions
- FindNotificationsEvents
- FindNotificationsProfiles
- CreateNotificationProfile
- DeleteNotificationProfile
- GetNotificationProfile
- UpdateNotificationProfile
- ListNotificationSettings
- CreateNotificationSetting
- DeleteNotificationSetting
- GetNotificationSetting
- ListDataUsageNotifications
- PostSimCardDataUsageNotification
- DeleteSimCardDataUsageNotifications
- GetSimCardDataUsageNotification
- PatchSimCardDataUsageNotification
- GetWebhookDeliveries
- GetWebhookDelivery
events:
- event: CallAIGatherEnded
  description: Call AI Gather Ended
  declared_in: webhooks
- event: CallAIGatherMessageHistoryUpdated
  description: Call AI Gather Message History Updated
  declared_in: webhooks
- event: CallAIGatherPartialResults
  description: Call AI Gather Partial Results
  declared_in: webhooks
- event: callAnswered
  description: Call Answered
  declared_in: webhooks
- event: callBridged
  description: Call Bridged
  declared_in: webhooks
- event: callConversationEnded
  description: Call Conversation Ended
  declared_in: webhooks
- event: callConversationInsightsGenerated
  description: Call Conversation Insights Generated
  declared_in: webhooks
- event: callCost
  description: Call Cost
  declared_in: webhooks
- event: callDeepfakeDetectionError
  description: Call Deepfake Detection Error
  declared_in: webhooks
- event: callDeepfakeDetectionResult
  description: Call Deepfake Detection Result
  declared_in: webhooks
- event: callDtmfReceived
  description: Call Dtmf Received
  declared_in: webhooks
- event: callEnqueued
  description: Call Enqueued
  declared_in: webhooks
- event: callForkStarted
  description: Call Fork Started
  declared_in: webhooks
- event: callForkStopped
  description: Call Fork Stopped
  declared_in: webhooks
- event: callGatherEnded
  description: Call Gather Ended
  declared_in: webhooks
- event: callHangup
  description: Call Hangup
  declared_in: webhooks
- event: callHold
  description: Call Hold
  declared_in: webhooks
- event: callInitiated
  description: Call Initiated
  declared_in: webhooks
- event: callLeftQueue
  description: Call Left Queue
  declared_in: webhooks
- event: callMachineDetectionEnded
  description: Call Machine Detection Ended
  declared_in: webhooks
- event: callMachineGreetingEnded
  description: Call Machine Greeting Ended
  declared_in: webhooks
- event: callMachinePremiumDetectionEnded
  description: Call Machine Premium Detection Ended
  declared_in: webhooks
- event: callMachinePremiumGreetingEnded
  description: Call Machine Premium Greeting Ended
  declared_in: webhooks
- event: callPlaybackEnded
  description: Call Playback Ended
  declared_in: webhooks
- event: callPlaybackStarted
  description: Call Playback Started
  declared_in: webhooks
- event: callRecordingError
  description: Call Recording Error
  declared_in: webhooks
- event: callRecordingSaved
  description: Call Recording Saved
  declared_in: webhooks
- event: callRecordingTranscriptionSaved
  description: Call Recording Transcription Saved
  declared_in: webhooks
- event: callReferCompleted
  description: Call Refer Completed
  declared_in: webhooks
- event: callReferFailed
  description: Call Refer Failed
  declared_in: webhooks
- event: callReferStarted
  description: Call Refer Started
  declared_in: webhooks
- event: callSiprecFailed
  description: Call Siprec Failed
  declared_in: webhooks
- event: callSiprecStarted
  description: Call Siprec Started
  declared_in: webhooks
- event: callSiprecStopped
  description: Call Siprec Stopped
  declared_in: webhooks
- event: callSpeakEnded
  description: Call Speak Ended
  declared_in: webhooks
- event: callSpeakStarted
  description: Call Speak Started
  declared_in: webhooks
- event: callStreamingFailed
  description: Call Streaming Failed
  declared_in: webhooks
- event: callStreamingStarted
  description: Call Streaming Started
  declared_in: webhooks
- event: callStreamingStopped
  description: Call Streaming Stopped
  declared_in: webhooks
- event: callUnhold
  description: Call Unhold
  declared_in: webhooks
- event: campaignStatusUpdate
  description: Campaign Status Update
  declared_in: webhooks
- event: conferenceCreated
  description: Conference Created
  declared_in: webhooks
- event: conferenceEnded
  description: Conference Ended
  declared_in: webhooks
- event: conferenceFloorChanged
  description: Conference Floor Changed
  declared_in: webhooks
- event: conferenceParticipantJoined
  description: Conference Participant Joined
  declared_in: webhooks
- event: conferenceParticipantLeft
  description: Conference Participant Left
  declared_in: webhooks
- event: conferenceParticipantPlaybackEnded
  description: Conference Participant Playback Ended
  declared_in: webhooks
- event: conferenceParticipantPlaybackStarted
  description: Conference Participant Playback Started
  declared_in: webhooks
- event: conferenceParticipantSpeakEnded
  description: Conference Participant Speak Ended
  declared_in: webhooks
- event: conferenceParticipantSpeakStarted
  description: Conference Participant Speak Started
  declared_in: webhooks
- event: conferencePlaybackEnded
  description: Conference Playback Ended
  declared_in: webhooks
- event: conferencePlaybackStarted
  description: Conference Playback Started
  declared_in: webhooks
- event: conferenceRecordingSaved
  description: Conference Recording Saved
  declared_in: webhooks
- event: conferenceSpeakEnded
  description: Conference Speak Ended
  declared_in: webhooks
- event: conferenceSpeakStarted
  description: Conference Speak Started
  declared_in: webhooks
- event: deliveryUpdate
  description: Delivery Update
  declared_in: webhooks
- event: fax.delivered
  description: Fax Delivered
  declared_in: webhooks
- event: fax.failed
  description: Fax Failed
  declared_in: webhooks
- event: fax.media.processed
  description: Fax Media Processed
  declared_in: webhooks
- event: fax.queued
  description: Fax Queued
  declared_in: webhooks
- event: fax.sending.started
  description: Fax Sending Started
  declared_in: webhooks
- event: hostedNumberOrderEvent
  description: Hosted Number Order Event
  declared_in: webhooks
- event: inboundMessage
  description: Inbound Message
  declared_in: webhooks
- event: numberOrderStatusUpdate
  description: Number Order Status Update
  declared_in: webhooks
- event: replacedLinkClick
  description: Replaced Link Click
  declared_in: webhooks
- event: transcription
  description: Transcription
  declared_in: webhooks
- event: initiated
  declared_in: components/schemas/InitiateCallRequest/properties/StatusCallbackEvent
- event: ringing
  declared_in: components/schemas/InitiateCallRequest/properties/StatusCallbackEvent
- event: answered
  declared_in: components/schemas/InitiateCallRequest/properties/StatusCallbackEvent
- event: completed
  declared_in: components/schemas/InitiateCallRequest/properties/StatusCallbackEvent
catalog:
  url: https://developers.telnyx.com/data/webhook-events.json
  verbatim: asyncapi/telnyx-webhook-events.json
  count: 96
  note: provider-published machine-readable webhook event catalog (payload examples per event), fetched 2026-10-08
delivery:
  source: https://developers.telnyx.com/docs/development/api-fundamentals/webhooks/receiving-webhooks + https://developers.telnyx.com/docs/voice/programmable-voice/voice-api-webhooks
    (2026-10-08)
  transport: HTTPS POST to a configured primary URL with an optional failover URL per product application/profile
  envelope: 'data{record_type: event, event_type, id, occurred_at, payload} + meta{attempt, delivered_to} for most
    V2 JSON callbacks; TeXML callbacks can be form-encoded'
  signature:
    headers:
    - telnyx-timestamp
    - telnyx-signature-ed25519
    algorithm: Ed25519 over the raw body bytes, verified against the account public key (https://portal.telnyx.com/#/api-keys/public-key)
    sdk_helpers: Node, Python, Go, Java, Ruby and PHP verification helpers reading TELNYX_PUBLIC_KEY
  acknowledgement: return 2xx promptly (some products require 200); process asynchronously and idempotently keyed
    on the event id
  retries: product-specific; Call Control retries on no response, 408 and 429 and fails over to webhook_event_failover_url;
    webhook_timeout_secs 0-30 per application; no single schedule is published
  ordering: events can be concurrent, duplicated, delayed or out of order; reconcile using occurred_at
  delivery_log: webhook_deliveries endpoints expose per-attempt request/response details