Listen to asset events

Learn how to listen to asset events using Studio webhooks.

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.created	This fires when an On Demand asset is created.
asset.updated	This fires when an On Demand asset is updated. The asset payload will contain a playback URL when playback is available.
asset.ready	This fires when an On Demand asset is ready. Playback will be available with all transcoded renditions.
asset.failed	This fires when an On Demand asset fails during the upload or during processing.
asset.deleted	This 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 the URL of the webhook endpoint. Select any asset event (with an asset prefix) and click “Create Webhook”.