Skip to navigation
Compatibility REST APIRecordingsWebhooks

Recording status callback

View as MarkdownOpen in Claude

Payload sent by SignalWire to your RecordingStatusCallback URL when a recording status event occurs.

Recordings are not always available immediately — especially at high call volumes. This callback lets your app react as soon as a recording is ready, whether that means uploading it to external storage, sending it via email, or forwarding the URL via SMS.

Configure RecordingStatusCallback when creating a call via the API or when using Dial, Conference, or Record.

Use RecordingStatusCallbackEvent to request callbacks for specific events. If omitted, only the completed event is sent. Possible values: in-progress, completed, absent.

StatusDescription
in-progressThe recording has begun.
completedThe file is available for access.
absentThe recording was too short or the call was silent — no audio was detected.

Status callbacks are advisory, best-effort notifications — delivery can be delayed or fail silently, so don’t gate time-critical actions on receiving one. See Status callback reliability.

Payload

The payload of this webhook request is an object.
AccountSidstringRequired
The unique ID of the project this call is associated with.
CallSidstringRequired
A unique identifier for the call. May be used to later retrieve this call from the REST API.
RecordingSidstringRequired
The unique identifier for the recording.
RecordingUrlstringRequired
The URL for the audio recording.
RecordingStatusenumRequired

The status of the recording.

  • in-progress: Recording has begun.
  • completed: File is available.
  • absent: Recording was too short or no audio was detected.
Allowed values:
RecordingDurationintegerRequired
The duration, in seconds, of the recording.
RecordingChannelsintegerRequired
The number of channels in the recording.
RecordingSourcestringRequired
The type of call that initiated the recording.

Response

200
Webhook received