Cloudflare Docs
Stream
Cloudflare Docs
Stream
Edit this page
Report an issue with this page
Log into the Cloudflare dashboard
Set theme to dark (⇧+D)
  1. Products
  2. Stream
  3. Stream live video
  4. Receive Live Webhooks

Receive Live Webhooks

Stream Live supports webhooks that notify your service when an Input connects or disconnects to Stream Live.

Stream Live Notifications

Who is it for?

Customers who are using Stream and want to receive webhooks with the status of their videos.

Other options / filters

You can input Stream Live IDs to receive notifications only about those inputs. If left blank, you will receive a list for all inputs.

The following input states will fire notifications. You can toggle them on or off:

  • live_input.connected
  • live_input.disconnected

Included with

Stream subscription.

What should you do if you receive one?

Stream notifications are entirely customizable by the customer. Action will depend on the customizations enabled.

​​ Subscribe to Stream Live Webhooks

  1. Log in to your Cloudflare account and click Notifications.
  2. From the Notifications page, click the Destinations tab.
  3. On the Destinations page under Webhooks, click Create.
  4. Enter the information for your webhook and click Save and Test.
  5. To create the notification, from the Notifications page, click the All Notifications tab.
  6. Next to Notifications, click Add.
  7. Under the list of products, locate Stream and click Select.
  8. Enter a name and optional description.
  9. Under Webhooks, click Add webhook and click your newly created webhook.
  10. Click Next.
  11. By default, you will receive webhook notifications for all Live Inputs. If you only wish to receive webhooks for certain inputs, enter a comma-delimited list of Input IDs in the text field.
  12. When you are done, click Create.

Example webhook payload
{
  "name": "Live Webhook Test",
  "text": "Notification type: Stream Live Input\nInput ID: eb222fcca08eeb1ae84c981ebe8aeeb6\nEvent type: live_input.disconnected\nUpdated at: 2022-01-13T11:43:41.855717910Z",
  "data": {
    "notification_name": "Stream Live Input",
    "input_id": "eb222fcca08eeb1ae84c981ebe8aeeb6",
    "event_type": "live_input.disconnected",
    "updated_at": "2022-01-13T11:43:41.855717910Z"
  },
  "ts": 1642074233

}

The event_type property of the data object will either be live_input.connected or live_input.disconnected.