Webhook is a post api road used to process asynchronously data in an api.

Contrary to the classic use of the API, when a webhook is used, the result of the request (here the audio-transcription) is not returned directly in response, but is posted on another API given by the client. This allows you to process a file without having to wait for it to finish.

It's as if a customer ordered something, but wanted to receive it at a different address than the one used to place the order.

How to test the webhook

The easiest way to test the webhook is to use an online address generator like https://webhook.site.

Go to this website, I click to ‘Copy to clipboard’ to get a test webhook url (ex: https://webhook.site/e1d794ca-e637-4a2a-81db-8a0fef1247bc).

Use this webhook in a request like:

curl -X 'POST' \
    'https://api.gladia.io/audio/text/audio-transcription/' \
    -H 'x-gladia-key: <your api key>' \
    -F "audio_url=http://files.gladia.io/example/audio-transcription/split_infinity.wav" \
    -F "https://webhook.site/e1d794ca-e637-4a2a-81db-8a0fef1247bc"

Send it, and check your page on https://webhook.site to see if it is working.