How to set up webhooks for real-time notifications?

Gladia supports webhooks so you can be automatically notified when your transcription jobs are completed. This allows you to build seamless workflows without constantly polling the API.

You can configure your webhook endpoint at:

👉 Gladia Dashboard – Webhook Settings

How It Works

You configure a webhook URL in your account settings.
Once a transcription finishes, Gladia will send a POST request to your endpoint.
The request body contains a JSON object with the transcription_id.
You can then use this transcription_id to fetch the full result through the API.

Request Body

The payload of the webhook POST request includes:

Field	Type	Description
`id`	String	Unique identifier of the transcription. Use this to retrieve results.

API References

Here are the official API docs for webhook events:

🆕 Webhook Creation: Created Event
✅ Success Event: Success Event
❌ Error Event: Error Event

Example Workflow

Upload audio file → Start transcription job.
Wait for webhook callback → Gladia notifies your configured endpoint when done.
Parse id → Extract it from the webhook request payload.
Fetch result → Use the Gladia API to get the complete transcription text.