Cloudflare · AsyncAPI Specification

Cloudflare Stream Webhooks

Version 1.0

Cloudflare Stream sends webhook notifications when videos finish processing and are ready to stream, or when a video enters an error state. Webhooks can also be configured for live streaming events. Configure a webhook URL in the Stream dashboard or via the API to receive these notifications.

View Spec View on GitHub AI GatewayAPI GatewayArtificial IntelligenceCDNCloudContainersDDoS ProtectionDNSEdgeEdge ComputingObject StoragePlatformReal-Time CommunicationSecurityServerlessWeb PerformanceAsyncAPIWebhooksEvents

Channels

/webhook

publish onStreamEvent

Receive Stream video event

Webhook channel that receives video processing and live streaming event notifications from Cloudflare Stream.

Messages

✉

VideoReady

Video Ready

Notification that a video has been processed and is ready to stream

✉

VideoError

Video Error

Notification that video processing has encountered an error

✉

LiveStreamStarted

Live Stream Started

Notification that a live stream has started

✉

LiveStreamEnded

Live Stream Ended

Notification that a live stream has ended

Servers

https

webhookEndpoint {webhookUrl}

Your configured webhook endpoint URL. Cloudflare Stream sends HTTP POST requests to this URL when video processing events occur. Validate the webhook-signing-key header to verify request authenticity.