Skip to main content
A recording started event emits when Daily begins to record a call. These can be activated via startRecording(), via the REST API, or within Prebuilt.

​
Common fields

​
version
string
Represents the version of the event. Uses semantic versioning to inform a consumer if the payload has introduced any breaking changes.
​
type
string
Represents the type of the event described in the payload.
​
id
string
An identifier representing this specific event.
​
payload
object
An object representing the event, whose fields are described below.
​
event_ts
number
Documenting when the webhook itself was sent. This timestamp is different than the time of the event the webhook describes.

​
Payload

​
recording_id
string
An ID identifying the recording that was generated.
​
action
string
A string describing the event that was emitted.
​
layout
object
The layout used for the recording.
​
started_by
string
The participant ID of the user who started the recording.
​
instance_id
string
The recording instance ID that was passed into the start recording command.
​
start_ts
integer
The Unix epoch time in seconds representing when the recording started.
{
  "version": "1.0.0",
  "type": "recording.started",
  "id": "rec-sta-c3df927c-f738-4471-a2b7-066fa7e95a6b-1692124183",
  "payload": {
    "action": "start-cloud-recording",
    "recording_id": "08fa0b24-9220-44c5-846c-3f116cf8e738",
    "layout": {
      "preset": "active-participant"
    },
    "started_by": "0a20567c-9e95-4fa7-aaa3-fb62f5be0449",
    "instance_id": "c3df927c-f738-4471-a2b7-066fa7e95a6b",
    "start_ts": 1692124183
  },
  "event_ts": 1692124183
}