Skip to main content
WEBHOOK
conferenceRecordingSaved
{
  "data": {
    "record_type": "event",
    "event_type": "conference.recording.saved",
    "id": "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
    "occurred_at": "2018-02-02T22:25:27.521992Z",
    "payload": {
      "call_control_id": "v3:MdI91X4lWFEs7IgbBEOT9M4AigoY08M0WWZFISt1Yw2axZ_IiE4pqg",
      "call_session_id": "428c31b6-7af4-4bcb-b7f5-5013ef9657c1",
      "client_state": "aGF2ZSBhIG5pY2UgZGF5ID1d",
      "channels": "single",
      "conference_id": "428c31b6-abf3-3bc1-b7f4-5013ef9657c1",
      "connection_id": "7267xxxxxxxxxxxxxx",
      "format": "mp3",
      "public_recording_urls": {
        "mp3": "http://example.com/recording.mp3",
        "wav": "http://example.com/recording.wav"
      },
      "recording_ended_at": "2018-02-02T22:20:27.521992Z",
      "recording_id": "4577f9a2-cf0e-44f3-ac57-9f95fb03fa47",
      "recording_started_at": "2021-05-11T10:17:03.692107Z",
      "recording_urls": {
        "mp3": "http://example.com/recording.mp3",
        "wav": "http://example.com/recording.wav"
      }
    }
  }
}

Headers

​
telnyx-timestamp
integer
required

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

​
telnyx-signature-ed25519
string
required

Base64 encoded Ed25519 signature for webhook verification - compatible with webhook-signature

Body

application/json
​
data
object
Example:
{
  "record_type": "event",
  "event_type": "conference.recording.saved",
  "id": "0ccc7b54-4df3-4bca-a65a-3da1ecc777f0",
  "occurred_at": "2018-02-02T22:25:27.521992Z",
  "payload": {
    "call_control_id": "v3:MdI91X4lWFEs7IgbBEOT9M4AigoY08M0WWZFISt1Yw2axZ_IiE4pqg",
    "call_session_id": "428c31b6-7af4-4bcb-b7f5-5013ef9657c1",
    "client_state": "aGF2ZSBhIG5pY2UgZGF5ID1d",
    "channels": "single",
    "conference_id": "428c31b6-abf3-3bc1-b7f4-5013ef9657c1",
    "connection_id": "7267xxxxxxxxxxxxxx",
    "format": "mp3",
    "public_recording_urls": {
      "mp3": "http://example.com/recording.mp3",
      "wav": "http://example.com/recording.wav"
    },
    "recording_ended_at": "2018-02-02T22:20:27.521992Z",
    "recording_id": "4577f9a2-cf0e-44f3-ac57-9f95fb03fa47",
    "recording_started_at": "2021-05-11T10:17:03.692107Z",
    "recording_urls": {
      "mp3": "http://example.com/recording.mp3",
      "wav": "http://example.com/recording.wav"
    }
  }
}

Response

200

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