Skip to content

Conversation

@rianvdm
Copy link
Contributor

@rianvdm rianvdm commented Jan 6, 2026

Summary

Documents the generic webhook payload schema for Cloudflare notifications, a frequently asked question from customers.

What this PR adds

New page: /notifications/reference/webhook-payload-schema/

Covers:

  • Payload structure — All fields in the generic webhook JSON payload
  • Field descriptions — Table explaining each field's type and purpose
  • Example payloads — Seven collapsible examples for common alert types (DDoS L4/L7, SSL certificate, health check, Workers, Access certificate, Workers observability)
  • Webhook validation — How to use cf-webhook-auth header

Updated: /notifications/get-started/configure-webhooks.mdx

  • Added link to new schema reference page from the generic webhooks section

Why

Questions about the format of webhook alert payloads come up frequently. This information was previously only available on an internal wiki page.

@github-actions
Copy link
Contributor

github-actions bot commented Jan 6, 2026

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/notifications/ @dcpena, @cloudflare/pcx-technical-writing

@rianvdm rianvdm assigned rianvdm and dcpena and unassigned dcpena and rianvdm Jan 6, 2026
@rianvdm
Copy link
Contributor Author

rianvdm commented Jan 6, 2026

cc @jasoncabot for review

…a.mdx

Co-authored-by: Jun Lee <junlee@cloudflare.com>
@rianvdm rianvdm merged commit 01991c9 into production Jan 9, 2026
9 checks passed
@rianvdm rianvdm deleted the rian/alert-webhook-payload-v2 branch January 9, 2026 16:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants