> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# Transcription status callback

POST 

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](/docs/compatibility-api/cxml/reference/voice/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.

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](/docs/platform/webhooks#status-callback-reliability).

Reference: https://signalwire.com/docs/compatibility-api/rest/recording-transcriptions/webhooks/transcription-status-callback

## Request

### Payload

- `TranscriptionSid` (string, required) — The unique, 34-character ID of the transcription.
- `TranscriptionText` (string, required) — The text of the transcription.
- `TranscriptionStatus` (enum, required) — The status of the transcription.
  - Allowed values: `completed`, `failed`
- `TranscriptionUrl` (string, required) — The URL for the transcription's REST API resource.
- `RecordingSid` (string, required) — The unique, 34-character identifier for the recording from which the transcription was generated.
- `RecordingUrl` (string, required) — The URL for the audio recording from which the transcription was generated.