Webhooks

Webhooks allow Media Manager to send information to your own application or service when the state of a video changes.

Creating Webhooks

You can specify a URL to call from your team settings page. Once a webhook has been added you can reveal the webhook secret that we have generated for you. We will sign every request with this secret allowing you to check the request is valid and comes from us.

The endpoint should return a 2xx response status to be considered successful. Media Manager will try sending the same call 2 more times before stopping if no success status was returned. A webhook will result in a failure if the server does not respond within 3 seconds.

Verifying webhooks

To ensure that the webhook data is genuine, it is recommended to verify the request by checking the signature generated by Media Manager and sent as a HTTP header in each webform request.

Logic to do this is provided as PHP code in the “Reveal Secret” pop-up:

Disabling Webhooks

To temporarily enable or disable a webhook, simply toggle the enabled switch.

Deleting Webhooks

An option to delete each webhook is available in the webhooks list:

Webhook events

Webhook events can be configured using the Manage events option. Select the events from the dropdown for which you want to receive webhook requests.

Media events

• video.created, audio.created media has been uploaded.
• video.upload.completed, audio.upload.completed media has finished processing and is ready to publish.
• video.upload.failed, audio.upload.failed an error occurred during processing.
• video.published, audio.published media has been marked as published.
• video.unpublished, audio.unpublished media has been marked as unpublished.
• video.updated, audio.updated data associated with your media has been changed.
• video.deleted, audio.deleted media has been deleted, and is due for removal in 14 days.
• video.restored, audio.restored media has been taken out of deleted state.
• video.static_rendition.ready, audio.static_rendition.ready a download for your media is now ready to use.
• video.master.ready, audio.master.ready the master asset for your media is ready to download.
• video.master.failed, audio.master.failed the master asset for your media failed to generate.

Livestream events

Livestream webhooks extend Media webhooks, when a livestream has been created the video.created or audio.created webhook will be called. The same applies for published, unpublished, updated and deleted events via the corresponding video and audio webhooks listed above.

• livestream.enabled a livestream has been marked as enabled, it can accept stream connections
• livestream.disabled a livestream has been marked as disabled, it can no longer accept stream connections
• livestream.started a livestream has been successfully received stream input and is actively broadcasting
• livestream.idle a livestream has returned to idle state, this happens automatically 60 seconds after a stream has disconnected