Use our webhooks to get notifications when your jobs are updated
Depending on the length and size of the video, some jobs can take some time to complete.
Instead of polling the API for the status of the job, you can use webhooks to get notified when the job is updated.
You can create a webhook by going to our webhooks page and clicking the Create Webhook
button.
From there you can specify the following:
Each webhook endpoint requires at least one event to be subscribed to.
Currently we support the following events:
transcribe.job.processing
transcribe.job.completed
transcribe.job.failed
extract.job.processing
extract.job.completed
extract.job.failed
file.job.processing
file.job.completed
file.job.failed
file.job.deleted
collection.file.job.processing
collection.file.job.completed
collection.file.job.failed
collection.file.job.deleted
You can subscribe to multiple events for the same endpoint.
To verify that the events you are receiving are from Cloudglue, we send a header with each request that contains the webhook secret for your particular endpoint.
By comparing the secret in the header to the secret for your endpoint, you can verify that the request is in fact from Cloudglue.
You can find the webhook secret for an endpoint by going to the webhooks page.
Example Header:
The payload will vary depending on the event.
It will always be a POST request with a JSON body.
To view the full object details, we recommend using the SDKs or APIs to make a request to fetch that object.
For more information on the full object details, please refer to the following sections:
The endpoint expects you to return a HTTP 200 status code to confirm receipt of the webhook.
If you return a non-200 status code, we will retry the webhook up to 3 times.
If you return a non-200 status code, we will retry the webhook up to 3 times.
After 3 retries, we will stop retrying the event and mark it as failed.
You can view past webhook events by going to the webhooks page, and clicking the View Events
button for an endpoint.
This will take you to a page where you can see the past events for an endpoint.
Want something more out of webhooks, tell us more about it in our Discord!
You can make up to 10 webhook endpoints per account.
Use our webhooks to get notifications when your jobs are updated
Depending on the length and size of the video, some jobs can take some time to complete.
Instead of polling the API for the status of the job, you can use webhooks to get notified when the job is updated.
You can create a webhook by going to our webhooks page and clicking the Create Webhook
button.
From there you can specify the following:
Each webhook endpoint requires at least one event to be subscribed to.
Currently we support the following events:
transcribe.job.processing
transcribe.job.completed
transcribe.job.failed
extract.job.processing
extract.job.completed
extract.job.failed
file.job.processing
file.job.completed
file.job.failed
file.job.deleted
collection.file.job.processing
collection.file.job.completed
collection.file.job.failed
collection.file.job.deleted
You can subscribe to multiple events for the same endpoint.
To verify that the events you are receiving are from Cloudglue, we send a header with each request that contains the webhook secret for your particular endpoint.
By comparing the secret in the header to the secret for your endpoint, you can verify that the request is in fact from Cloudglue.
You can find the webhook secret for an endpoint by going to the webhooks page.
Example Header:
The payload will vary depending on the event.
It will always be a POST request with a JSON body.
To view the full object details, we recommend using the SDKs or APIs to make a request to fetch that object.
For more information on the full object details, please refer to the following sections:
The endpoint expects you to return a HTTP 200 status code to confirm receipt of the webhook.
If you return a non-200 status code, we will retry the webhook up to 3 times.
If you return a non-200 status code, we will retry the webhook up to 3 times.
After 3 retries, we will stop retrying the event and mark it as failed.
You can view past webhook events by going to the webhooks page, and clicking the View Events
button for an endpoint.
This will take you to a page where you can see the past events for an endpoint.
Want something more out of webhooks, tell us more about it in our Discord!
You can make up to 10 webhook endpoints per account.