Sign in

v36

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-1279125449.6 KB
Recording Transcriptions

Transcription status callback

Payload sent by SignalWire to your Transcription Status Callback URL when the status of a transcription changes.

Configure this callback by enabling transcription on a recording via the Record verb (transcribe=true) and setting transcribeCallback to your webhook URL.

Your app can use these parameters to handle the transcription — for example, uploading the text to your CRM, sending it via email, or forwarding the body via SignalWire SMS.

postWebhooktranscriptionStatusCallback

Payload

TranscriptionSidstring required

The unique, 34-character ID of the transcription.

TranscriptionTextstring required

The text of the transcription.

TranscriptionStatus'completed' | 'failed' required

The status of the transcription.

TranscriptionUrlstring required

The URL for the transcription's REST API resource.

RecordingSidstring required

The unique, 34-character identifier for the recording from which the transcription was generated.

RecordingUrlstring required

The URL for the audio recording from which the transcription was generated.

Example payload

{
  "TranscriptionSid": "b3877c40-da60-4998-90ad-b792e984tr01",
  "TranscriptionText": "Hello, I'd like to schedule an appointment for next Tuesday.",
  "TranscriptionStatus": "completed",
  "TranscriptionUrl": "https://example.signalwire.com/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Transcriptions/b3877c40-da60-4998-90ad-b792e984tr01",
  "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"
}

Response

Webhook received