Texml recording completed

Webhook sent when a recording is completed during a TeXML call (triggered by recordingStatusCallbackEvent). 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.

WEBHOOK TexmlRecordingCompletedWebhook

Example

{
  "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.