Skip to main content
WEBHOOK
TexmlRecordingCompletedWebhook
{
  "AccountSid": "cb6cfbbc-eb00-41af-a3f3-0d7b32009e4b",
  "CallSid": "v2:qiaymU9Ij90xJRRkYGWHOIx_41EVJPrzlny2zC67hwL1wVIUnnMrqQ",
  "CallSidLegacy": "v2:qiaymU9Ij90xJRRkYGWHOIx_41EVJPrzlny2zC67hwL1wVIUnnMrqQ",
  "ConnectionId": "1234567890",
  "RecordingChannels": 1,
  "RecordingDuration": "5",
  "RecordingSid": "35094891-3290-4142-b2c2-b2eda57534cf",
  "RecordingSource": "DialVerb",
  "RecordingStatus": "completed",
  "RecordingUrl": "https://recording.com/your-recording-url"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
telnyx-timestamp
integer<int64>
required

Unix timestamp (seconds since epoch) of when the webhook was sent - compatible with webhook-timestamp Unix timestamp for replay attack prevention

​
telnyx-signature-ed25519
string
required

Base64 encoded Ed25519 signature for webhook verification - compatible with webhook-signature Ed25519 signature of timestamp|payload for verification

Body

application/x-www-form-urlencoded

Webhook sent when a recording is completed during a TeXML call (triggered by recordingStatusCallbackEvent).

​
AccountSid
string
required

The unique identifier of the account (user_id).

Example:

"cb6cfbbc-eb00-41af-a3f3-0d7b32009e4b"

​
CallSid
string
required

The unique identifier of the call (call_control_id).

Example:

"v2:qiaymU9Ij90xJRRkYGWHOIx_41EVJPrzlny2zC67hwL1wVIUnnMrqQ"

​
CallSidLegacy
string
required

Legacy call identifier, same as CallSid.

Example:

"v2:qiaymU9Ij90xJRRkYGWHOIx_41EVJPrzlny2zC67hwL1wVIUnnMrqQ"

​
ConnectionId
string
required

The unique identifier of the connection.

Example:

"1234567890"

​
RecordingChannels
enum<integer>
required

The number of channels in the recording (1 for mono, 2 for dual-channel).

Available options:
1,
2
Example:

1

​
RecordingDuration
string
required

The duration of the recording in seconds.

Example:

"5"

​
RecordingSid
string
required

A unique identifier for the recording, generated by Telnyx.

Example:

"35094891-3290-4142-b2c2-b2eda57534cf"

​
RecordingSource
string
required

The source of the recording.

Example:

"DialVerb"

​
RecordingStatus
enum<string>
required

The status of the recording.

Available options:
completed
Example:

"completed"

​
RecordingUrl
string

The URL where the recording can be accessed (conditional, only present if recording URL is available).

Example:

"https://recording.com/your-recording-url"

Response

200

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