JWX 's webhooks allow you to automate your workflow by sending notifications to a designated URL endpoint when specific events occur, such as a new video is uploaded or a Broadcast Live stream is idle.
Webhook creation page
Follow these steps to create a webhook:
On the Webhooks Create webhook . The new page appears.
Under General , enter a Name for the webhook.
(Optional) Enter a Description for the webhook.
Enter the webhook URL .
Under Properties , select one or several properties.
Under Events , select one or several events .
Click Save webhook . The new webhook will appear in the list of webhooks.
📘 When creating webhooks in your account, you will only see events that correspond to your enabled account features and entitlements.
Event Description Complete Notification sent when both the thumbnail is ready and all initial video renditions have been processed
Event Example JSON
{
"event": "conversions_complete",
"media_id": "MNYaMSQl",
"webhook_id": "2yW4KmiG",
"site_id": "9KboGBFu",
"event_time": "2024-08-27T00:20:57+00:00"
}
Event Description Is active Notification sent when a Live Channel enters an active state
Event Example JSON
{
"event": "channel_active",
"channel_id": "YijbmYHJ",
"webhook_id": "2yW4KmiG",
"site_id": "9KboGBFu",
"event_time": "2024-08-29T03:01:24+00:00"
}
Is idle Notification sent when a Live Channel enters an idle state
Event Example JSON
{
"event": "channel_idle",
"channel_id": "t8JLGRl9",
"webhook_id": "2yW4KmiG",
"site_id": "9KboGBFu",
"event_time": "2024-08-29T03:00:34+00:00"
}
Created Notification sent when a Live Channel is created
Event Example JSON
{
"event": "channel_created",
"channel_id": "YijbmYHJ",
"webhook_id": "2yW4KmiG",
"site_id": "9KboGBFu",
"event_time": "2024-08-29T02:59:57+00:00"
}
Event Description Available Notification sent when media is first publishable and indexed
Media Available notification will be sent.
Event Example JSON
{
"event": "media_available",
"media_id": "MNYaMSQl",
"webhook_id": "2yW4KmiG",
"site_id": "9KboGBFu",
"event_time": "2024-08-27T00:15:45+00:00"
}
Created Notification sent when media has been first uploaded
Event Example JSON
{
"event": "media_created",
"media_id": "MNYaMSQl",
"webhook_id": "2yW4KmiG",
"site_id": "9KboGBFu",
"event_time": "2024-08-27T00:13:10+00:00"
}
Deleted Notification sent when media has been deleted
Event Example JSON
{
"event": "media_deleted",
"media_id": "MNYaMSQl",
"webhook_id": "2yW4KmiG",
"site_id": "9KboGBFu",
"event_time": "2024-08-27T01:14:01+00:00"
}
Reuploaded Notification sent when a media has been reuploaded
Media Reuploaded notification is the point at which the reupload has been initiated, not the time at which the reupload has been fully processed. You will receive Conversion Complete and Media Available notifications when conversions have been indexed and the media is first publishable.
Event Example JSON
{
"event": "media_reuploaded",
"media_id": "MNYaMSQl",
"webhook_id": "2yW4KmiG",
"site_id": "9KboGBFu",
"event_time": "2024-08-27T01:09:24+00:00"
}
Updated Notification sent when a media is updated
Media Updated notification is sent when any fields in the metadata or relationships objects of a media item are updated using the media patch endpoint directly or where used in the JWX dashboard.
Event Example JSON
{
"event": "media_updated",
"media_id": "MNYaMSQl",
"webhook_id": "2yW4KmiG",
"site_id": "9KboGBFu",
"event_time": "2024-08-27T01:05:28+00:00"
}
Event Description Created Notification sent when the Broadcast Live stream has been successfully created
Event Example JSON
{
"event": "stream_created",
"stream_id": "IfufXrxY",
"webhook_id": "mvYr6Twx",
"site_id": "HFWDaPJo",
"event_time": "2024-09-17T14:41:47+00:00",
"data": {
"status": "requested"
}
}
Deleted Notification sent when the the Broadcast Live stream has been deleted
Event Example JSON
{
"event": "stream_deleted",
"stream_id": "IfufXrxY",
"webhook_id": "mvYr6Twx",
"site_id": "HFWDaPJo",
"event_time": "2024-09-17T14:57:47+00:00",
"data": {
"status": "deleted"
}
}
Go live Notification sent when the Broadcast Live stream has become available
Event Example JSON
{
"event": "stream_go_live",
"stream_id": "IfufXrxY",
"webhook_id": "mvYr6Twx",
"site_id": "HFWDaPJo",
"event_time": "2024-09-17T14:47:47+00:00",
"data": {
"status": "streaming"
}
}
Transitioned Notification sent when the Broadcast Live stream has transitioned to a new state
Event Example JSON
{
"event": "stream_transitioned",
"stream_id": "IfufXrxY",
"webhook_id": "mvYr6Twx",
"site_id": "HFWDaPJo",
"event_time": "2024-09-17T14:47:47+00:00",
"data": {
"status": "streaming"
}
}
Updated Notification sent when the properties of the Broadcast Live stream have changed
Event Example Ingest Updated Playout Updated
{
"event": "stream_updated",
"stream_id": "IfufXrxY",
"webhook_id": "mvYr6Twx",
"site_id": "HFWDaPJo",
"event_time": "2024-09-17T14:50:07+00:00",
"data": {
"status": "stopping",
"ingest": {
"rtmp": {},
"srt": {
"ingest_point": {
"url": "srt://ingest-9fbb8955abe1.jwplive.com:8000/"
}
},
"srt_pull": {},
"rtp": {},
"hls_pull": {},
"rtp_fec": {},
"zixi_push": {}
}
}
}
{
"event": "stream_updated",
"stream_id": "IfufXrxY",
"webhook_id": "mvYr6Twx",
"site_id": "HFWDaPJo",
"event_time": "2024-09-17T14:50:08+00:00",
"data": {
"status": "stopping",
"playout": {
"hls": "https://livecdn.use1-0004.jwplive.com/live/sites/HFWDaPJo/media/IfufXrxY/live.isml/.m3u8?t=2024-09-17T14:47:33-2024-09-17T14:49:02",
"dash": "https://livecdn.use1-0004.jwplive.com/live/sites/HFWDaPJo/media/IfufXrxY/live.isml/.mpd?t=2024-09-17T14:47:33-2024-09-17T14:49:02"
}
}
}
Event Description Asset created Notification sent when a new asset is created from a JWX Studio transformation run
Event Example JSON
{
"event": "transformation_asset_created",
"transformation_asset_id": "B123cdE4",
"webhook_id": "abc098d7",
"site_id": "EfghIjK0",
"event_time": "2026-01-26T20:35:05+00:00",
"data": {
"asset_type": "audio",
"project_id": "Zy987xw6",
"metadata": {
"article_audio_variant_id": "Zy678xw9",
"media_id": "Zy567xw8",
"variant_type": "verbatim"
}
}
}
Awaiting approval Notification sent when a JWX Studio transformation run has assets to review before continuing
Event Example JSON
{
"event": "transformation_run_step_awaiting_approval",
"transformation_run_step_id": "step9999",
"webhook_id": "abc098d7",
"site_id": "EfghIjK0",
"event_time": "2026-01-26T20:35:05+00:00",
"data": {
"status": "needs_review",
"transformation_run_id": "runid123",
"step_type": "review_audio",
"review_url": "https://dashboard.jwplayer.com/p/siteid12/transformations/review/step9999"
}
}
Run state changed Notification sent when the state of a JWX Studio transformation run has changed
Event Example JSON
{
"event": "transformation_run_state_changed",
"transformation_run_id": "B123cdE4",
"webhook_id": "abc098d7",
"site_id": "EfghIjK0",
"event_time": "2026-01-26T20:35:05+00:00",
"data": {
"status": "succeeded|failed|awaiting_approval",
"project_id": "Zy987xw6",
"transformation_type": "article_to_audio"
}
}
Event Description Created Notification sent when a thumbnail is created
Event Example JSON
{
"event": "thumbnail_created",
"thumbnail_id": "k9x00iro",
"webhook_id": "2yW4KmiG",
"site_id": "9KboGBFu",
"event_time": "2024-08-27T00:13:25+00:00",
"media_id": "MNYaMSQl"
}
Deleted Notification sent when a thumbnail is deleted
Event Example JSON
{
"event": "thumbnail_deleted",
"thumbnail_id": "sl5swh3z",
"webhook_id": "2yW4KmiG",
"site_id": "9KboGBFu",
"event_time": "2024-08-27T01:14:01+00:00",
"media_id": "MNYaMSQl"
}
Event Description Created Notification sent when a track is created
Event Example JSON
{
"event": "track_created",
"track_id": "VHsQNYq9",
"webhook_id": "2yW4KmiG",
"site_id": "9KboGBFu",
"event_time": "2024-08-27T00:58:57+00:00",
"media_id": "MNYaMSQl"
}
Deleted Notification sent when a track is deleted
Event Example JSON
{
"event": "track_deleted",
"track_id": "VHsQNYq9",
"webhook_id": "2yW4KmiG",
"site_id": "9KboGBFu",
"event_time": "2024-08-27T01:02:03+00:00",
"media_id": "MNYaMSQl"
}
