Skip to main content

Webhooks

VP Player offers webhooks for Videos, Video Players, Ad Schedules, Live Videos, Live Channels, Audios, Audio Players,, Vertical Players, Playlists and Podcasts!

You can setup webhooks directly from VP Player client interface through Properties > Webhooks, or follow the steps on the api documentation Manage API > Webhooks.

In VP Player you can create webhooks in order to automate notifications in the form of HTTP POST requests and send to registered subscribers from VP Player to notify them of an event happening in a service. Webhook will be active if a user chooses to activate it. You can setup an endpoint that must be a secure URL in which we will send HTTP requests and specify what events you are listening to in webhook filters. A webhook will be disabled (inactive) if there are multiple event message delivery failures as described in section below or if a user chooses to manually deactivate it. To receive events, a webhook subscriber must add the desired events (filters). Once an event happens we will send to you a message. If an attempt to send a webhook message has already failed we will retry according to this schedule:

  • Immediately
  • 5 seconds
  • 5 minutes
  • 30 minutes
  • 2 hours
  • 5 hours
  • 10 hours
  • 10 hours (in addition to the previous)

If all attempts to a specific webhook endpoint fail for a period of 5 days, the webhook will be disabled automatically.

Video Webhooks​

Video webhooks include these events: video.created, video.updated, video.deleted, video.publish.status.changed, video.encode.started, video.encode.completed, video.encode.errored, video.encode.quality.started, video.encode.quality.completed, video.encode.quality.errored, video.encode.submitted, video.thumbnail.changed

Video Player Webhooks​

Player webhooks include these events: player.created, player.updated, player.deleted, player.version.changed

AdSchedule Webhooks​

Adschedule webhooks include these events: adschedule.created, adschedule.updated, adschedule.deleted

Live Video Webhooks​

Live Video webhooks include these events: live.video.created, live.video.updated, live.video.deleted, live.video.status.changed, live.video.stopped, live.video.started, live.video.thumbnail.changed

Live Channel Webhooks​

Live Channel webhooks include these events: live.channel.created, live.channel.updated, live.channel.deleted, live.channel.status.changed

Audio Webhooks​

Audio webhooks include these events: audio.created, audio.deleted, audio.updated, audio.publish.status.changed, audio.encode.started, audio.encode.completed, audio.encode.errored, audio.encode.quality.started, audio.encode.quality.completed, audio.encode.quality.errored

Audio Player Webhooks​

Audio Player webhooks include these events: audio.player.created, audio.player.updated, audio.player.deleted, audio.player.version.changed

Vertical Player Webhooks​

Vertical Player webhooks include these events: vertical.player.created, vertical.player.updated, vertical.player.deleted

Playlist Webhooks​

Playlist webhooks include these events: playlist.created, playlist.updated, playlist.deleted

Podcast Webhooks​

Podcast webhooks include these events: podcast.created, podcast.updated, podcast.deleted

Subtitles Webhooks​

Subtitles webhooks include this event: video.subtitle.autogenerated.completed