Skip to content
Stream
Visit Stream on GitHub
Set theme to dark (⇧+D)

Getting Live Webhooks

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

Example Webhook Payload

The webhook payload will look similar to this:

{
"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.

Subscribe to Stream Live Webhooks

  1. Log in to your Cloudflare account and click Notifications.

Click on Notifications

  1. From the Notifications page, click the Destinations tab. Click on Destinations

  2. On the Destinations page under Webhooks, click Create.

  3. Enter the information for your webhook and click Save and Test. Configure Destination

  4. To create the notification, from the Notifications page, click the All Notifications tab.

  5. Next to Notifications, click Add. Click Add on Notificatons page

  6. Under the list of products, locate Stream and and click Select. Select Stream

  7. Enter a name and optional description.

  8. Under Webhooks, click Add webhook and click your newly created webhook.

  9. Click Next. Configure Notification

  10. 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. Finish Notification Setup

  11. When you are done, click Create.