Skip to content

Clarify permissions for notifications and webhooks #20741

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Apr 1, 2025
Merged

Clarify permissions for notifications and webhooks #20741

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a252564
Clarify permissions for notifications and webhooks
jasoncabot Mar 12, 2025
ce3d30c
Small edit
dcpena Apr 1, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions src/content/docs/notifications/get-started/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,10 +17,12 @@ You can check the [Notification History](/notifications/notification-history/) u

To create a notification via the Cloudflare dashboard, you will need to have the Super Administrator or Administrator role.

You can also create a notification if you have an edit role for the feature that you want to create an alert for. For example, if you want to create a Load Balancing Pool Enablement notification, you will need to have the Load Balancer role.
You can also create a notification if you have the account edit role, which allows you create any type of notification.

An API token needs to have the [Notifications Read/Write permission](https://developers.cloudflare.com/fundamentals/api/reference/permissions/) to create a notification,

Some notifications can only be created if you have a Professional, Business or Enterprise account or if you are using a particular Cloudflare product.

## Configure notifications

This guide will help you create, edit, test, or delete notifications using the Cloudflare dashboard.
Expand All @@ -38,7 +40,7 @@ You can create a notification via the Cloudflare dashboard.

:::note

Professional and Business plans will have access to other options such as configuring PagerDuty or accessing webhooks.
Professional and Business plans will have access to more notifications and PagerDuty. Accounts with a paid service will additionally have access to webhooks.
:::

6. (Optional) Specify any additional options for the notification, if required. For example, some notifications require that you select one or more domains or services.
Expand Down