---
title: "Transcription status callback"
method: POST
path: "transcriptionStatusCallback"
tags: ["Recording Transcriptions"]
---

# Transcription status callback

`POST transcriptionStatusCallback` (webhook)

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

## Payload

- object — 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).
  - `TranscriptionSid` string, required — The unique, 34-character ID of the transcription.
  - `TranscriptionText` string, required — The text of the transcription.
  - `TranscriptionStatus` 'completed' | 'failed', required — The status of the transcription.
  - `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.

## Acknowledgement `200`

Webhook received

---

[API](https://skmtc.net/signalwire/apis/compatibility-api.md) · [All operations](https://skmtc.net/signalwire/apis/compatibility-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signalwire/compatibility-api/versions/e6faba43acd7/schema)