Sygnal | KB | Creating a Cloudflare Stream Webhook

Published

January 3, 2026

Cloudflare stream can perform callbacks to a webhook to notify your application when video processing is complete and the stream is ready to play.

However the process is poorly documented and very confusing.

Webhook Setup Process

Create your Webhook

First create the webhook that will be receiving your Cloudflare stream notifications.

Create an API token

Next you have to create a special API token for creating API tokens.

https://dash.cloudflare.com/<ACCOUNT_ID>/api-tokens

Create the token with permission;

Account.API Tokens
Account.Stream

Once you have that token, you can use it in the next step to register your webhook.

Register Your Webhook

Using bash-

curl -X PUT --header 'Authorization: Bearer <API_TOKEN>' \
https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/stream/webhook \
--data '{"notificationUrl":"<WEBHOOK_NOTIFICATION_URL>"}'

References

https://developers.cloudflare.com/stream/manage-video-library/using-webhooks/

R&D

Can more than one webhook ( e.g. DEV and PROD be registered to the same event )

Are there any problems with