Webhooks collection

Media related events

These events notify your system about the upload, creation, availability, or failure of media assets, such as videos or audio files. They also track when media assets are updated or deleted, allowing your system to respond accordingly.

Event Name	Description	Use Case
`video.media.created`	Triggered when a new media has been successfully created (Pull from URL).	Notify your system when media is available on the platform.
`video.media.upload`	Indicates that a direct upload has been initiated. The user or system requests an upload URL. (Push media)	Useful for tracking when users start uploading media through your app.
`video.upload.media_created`	A media asset has been created from an upload. Triggered when an end user finishes uploading a file through a direct upload URL.	Track when a media is successfully created after an upload.
`video.media.ready`	Triggered when the media (video or audio) is ready for playback. Used for both Push and Pull.	Use the `playbackId` to initiate streaming of the media.
`video.media.failed`	Triggered when the media asset encounters an error during processing (e.g., invalid input URL).	Notify your system about errors for debugging or user notifications.
`video.media.deleted`	Triggered when a media asset has been deleted.	Remove references to the media, as it is no longer available.
`video.media.updated`	Triggered when an existing media is updated.	Sync your system to reflect any changes made to the media.
`video.media.live_stream.created`	Triggered when a live stream is recorded into an on-demand media. A manifest file is created and a `playbackId` is generated for streaming.	Useful for handling live stream recordings and initiating on-demand playback.

Live stream related events

These events track the full lifecycle of live streams, including creation, connection, and when the stream goes live or becomes idle. Additionally, they monitor the recording process and provide updates when streams are updated, enabled, disabled, or deleted.

Webhook	Description
`video.live_stream.created`	A new live stream has been created. Broadcasters possessing a stream key can commence transmitting their encoder feed to this particular live stream.
`video.live_stream.preparing`	Status indicates that the live stream is being initialized and set up. During this phase, the system is validating inputs and allocating resources before going live.
`video.live_stream.connected`	The live stream is in a "connected" status for video live streaming, confirming that an encoder has established a successful connection to it.
`video.live_stream.recording`	The live stream's video recording is now in progress.
`video.live_stream.active`	The live stream is currently marked as "active," signifying that it is presently "live" and actively broadcasting.
`video.live_stream.disconnected`	When the stream is stopped, causing the encoder to become disconnected.
`video.live_stream.idle`	The live stream enters an "idle" state as there is no ongoing streaming activity.
`video.media.live_stream.created`	This event is triggered when a live stream gets recorded and a new media has been successfully created as video-on-demand. Use this to notify your system when media is available in the platform.
`video.live_stream.updated`	The live stream has been either updated, or the stream key for this livestream has been reset.
`video.live_stream.deleted`	The live stream has been deleted.

Simulcast target events

Simulcast target events give real-time updates on the status of third-party endpoints used in live streaming. They help you track the creation and deletion of simulcast targets, allowing your system to reflect their current status accurately in the user interface.

Webhooks	Description
`video.live_stream.simulcast_target.created`	A new simulcast has been created for a live stream.
`video.live_stream.simulcast_target.deleted`	When the simulcast of a live stream has been deleted.
`video.live_stream.simulcast_target.updated`	When the simulcast of a live stream has been updated.