Sign in

v36

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-1279125449.6 KB
Recordings

Recording status callback

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.
postWebhookrecordingStatusCallback

Payload

AccountSidstring required

The unique ID of the project this call is associated with.

CallSidstring required

A unique identifier for the call. May be used to later retrieve this call from the REST API.

RecordingSidstring required

The unique identifier for the recording.

RecordingUrlstring required

The URL for the audio recording.

RecordingStatus'in-progress' | 'completed' | 'absent' required

The status of the recording.

  • in-progress: Recording has begun.
  • completed: File is available.
  • absent: Recording was too short or no audio was detected.
RecordingDurationinteger required

The duration, in seconds, of the recording.

RecordingChannelsinteger required

The number of channels in the recording.

RecordingSourcestring required

The type of call that initiated the recording.

Example payload

{
  "AccountSid": "b3877c40-da60-4998-90ad-b792e98472af",
  "CallSid": "b3877c40-da60-4998-90ad-b792e98472ca",
  "RecordingSid": "b3877c40-da60-4998-90ad-b792e984re01",
  "RecordingUrl": "https://example.signalwire.com/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Recordings/b3877c40-da60-4998-90ad-b792e984re01",
  "RecordingStatus": "completed",
  "RecordingDuration": 94,
  "RecordingChannels": 1,
  "RecordingSource": "RecordVerb"
}

Response

Webhook received