Call Recording Events

Use this event to receive a recording link when a call recording becomes available in the system.

Subscribe to this webhook on the Administration > Webhooks page. For parameter descriptions, refer to the Webhook Overview article.

Event	Description
call.recording.available	Event triggered when a call recording becomes available.

call.recording.available

Use this event to:

Retrieve the call recording via a pre-signed URL hosted on the CDR
Simplify integration with CRMs or external systems by using a 24-hour link
Eliminate the need for a dedicated AWS S3 bucket

This event is only triggered when enabled for contact centers on the Pro Plus plan that have call recording enabled.

Sample Payload Structure

The following sample shows the structure of this webhook payload and highlights where standard objects—documented in the Webhook Overview—are used.

{
  "event": "call.recording.available",
  "object": "call",
  "timestamp": "2025-05-24T08:36:39Z",
  "secret": "45XXYYZZa08",
  "contact_center_id": "187edc75-XXXX-44e3-8798-aa0bbc12yt703",
  "data": {
    // call object
    // agent object
    // wrap_up_code object (optional)
  }
}

Example payload

{
  "event": "call.recording.available",
  "object": "call",
  "timestamp": "2025-05-24T08:36:39Z",
  "secret": "45XXYYZZa08",
  "contact_center_id": "187edc75-XXXX-44e3-8798-aa0bbc12yt703",
  "data": {
    "id": "1a234567-XXXX-012a-3456-b7c8de90a1b2",
    "type": "outbound",
    "start_time": "2025-05-24T06:53:50Z",
    "end_time": "2025-04-24T06:54:20Z",
    "duration": {
      "total": 30,
      "dialing_time": 5,
      "talk_time": 20,
      "hold_time": 5,
      "postcall_time": 10
    },
    "disposition": "Answered",
    "end_reason": "Contact disconnect",
    "calling_number": "123456789090",
    "called_number": "909087654321",
    "wrap_up_code": {
      "code": "1234",
      "description": "Send Invoice"
    },
    "notes": "The contact is looking for an updated invoice.",
    "cdr_url": "https://cluster1.contact_center_name.com/cdr/1a234567-XXXX-012a-3456-b7c8de90a1b2",
    "recording": "https://ush9828hod3diwns/2025/05/24/187e8798-aa0bb6962503.mp3",
    "agent": {
      "id": 1,
      "name": "James Carter",
      "email": "jc@example.com",
      "extension": "1234"
    }
  }
}

Note: The recording field contains a pre-signed URL that expires after 24 hours.

See also