notifications.*) control which categories of notifications a user can receive. Unlike API and page permissions which gate access, notification permissions determine subscription — a user without a given notification permission simply won’t receive those notifications.
Individual notification preferences (email, push, in-app) are configured separately per user. The permissions below control whether a user is eligible to receive a category of notifications at all.
Core notification permissions
Notification categories
These permissions control eligibility for specific notification categories. They are used in the permissions management UI to group notification subscriptions.Targeted notification permissions
These permissions are used bynotifyUsersWithPermission() to send notifications to all users holding a specific key, rather than gating a category.
How notification routing works
When a notification event occurs (e.g. a new job is created), the system:- Determines which notification permission category applies (e.g.
notifications.jobs) - Finds all users who hold that permission
- Filters by each user’s individual notification preferences (email / push / in-app)
- Delivers the notification through the selected channels
notifyUsersWithPermission('permission.key') to send directly to all holders of that specific key, bypassing category routing.