Livepeer Studio uses webhooks to communicate with your application asynchronously when events for your asset occur. For example, you may want to know when an asset has been uploaded or is ready, so that you can surface this information to viewers.

When these events happen, you can configure Studio to make a POST request to a webhook URL that you specify.

Type of asset events

asset.createdThis fires when an On Demand asset is created.
asset.updatedThis fires when an On Demand asset is updated. The asset payload will contain a playback URL when playback is available.
asset.readyThis fires when an On Demand asset is ready. Playback will be available with all transcoded renditions.
asset.failedThis fires when an On Demand asset fails during the upload or during processing.
asset.deletedThis fires when an On Demand asset is deleted.

Set up a webhook endpoint

The first step is to set up a webhook endpoint in your application. This is the URL that Livepeer Studio will send the event to - learn more about setting up a webhook endpoint.

Add a webhook URL to Livepeer Studio

Log in to the Livepeer Studio and navigate to the Developers/Webhooks page.


Click the “Create Webhook” button and enter URL of webhook endpoint. Select any asset event (with an asset prefix) and click “Create Webhook”.