What are notification configs?
Language

Notifications

Configure rule-based notification configs with triggers, domain scoping, and destinations like email, webhooks, Slack, Discord, Jira, Linear, and S3.

What are notification configs?

Notification configs are rule-based alert configurations that let you define what triggers a notification, which domains it applies to, and where the notification is delivered. They are managed at the team level from Team Settings > Notifications.

Each config consists of three parts:

  1. Trigger - the event type that fires the notification (e.g., a malicious script detected)
  2. Domain scope - which domains the rule applies to (all domains or specific ones)
  3. Destinations - where the notification is sent (email, webhook, Slack, Jira, Linear, or S3)

You can create multiple notification configs per team, each with different triggers, scopes, and destinations.

Creating a notification config

  1. Open the dashboard and navigate to Team Settings
  2. Select the Notifications tab
  3. Click Create Notification Config
  4. Enter a Rule Name (e.g., “Monitor PCI compliance” or “Slack alerts for threats”)
  5. Select a trigger from the Trigger Library
  6. Configure the domain scope - choose all domains (including future ones) or select specific domains
  7. Add one or more destinations under “Send To”
  8. Configure each destination’s settings in the Configuration panel
  9. Click Save or Save & Test to create the config
Save & Test

Save & Test creates the notification config and immediately sends a test notification to all configured destinations, so you can verify everything is working.

Trigger library

The trigger library contains six event types you can use in your notification configs. Some triggers deliver notifications in real time, while others aggregate events into a daily or weekly digest.

TriggerDescriptionDelivery
Script Threat DetectedFires when the rules engine detects a malicious or suspicious scriptReal-time
Vulnerable Script DetectedFires when a vulnerable or high-risk script is detected on a monitored domainReal-time
Managed List: FlaggedFires when a script matches c/side’s curated threat intelligence listReal-time
Web Script ReleaseFires when a new version of the c/side monitoring script is releasedReal-time
PCI Report AvailablePCI compliance reports delivered as a scheduled digestDigest (daily or weekly)
Script Blocked by CSPCSP block events aggregated into a scheduled digest to reduce noiseDigest (daily or weekly)

Real-time vs. digest triggers

Real-time triggers send a notification immediately when the event occurs. Use these for security-critical events like threat detections and vulnerability alerts.

Digest triggers aggregate events and deliver them on a schedule (daily or weekly). This prevents alert fatigue for high-frequency events like CSP blocks or recurring compliance reports.

When you select a digest trigger, you will be prompted to choose a delivery schedule.

Domain scope

Each notification config can be scoped to specific domains or applied to all domains in your team:

  • All domains (including future domains) - the rule applies to every domain in your team, including any domains added later
  • Specific domains - select one or more domains from a list. The rule only triggers for events on those domains

Destinations

Destinations define where notifications are delivered. You can add multiple destinations to a single config - for example, send threat alerts to both Slack and Jira simultaneously.

DestinationDescriptionSetup guide
EmailSend notifications to team members or external email addressesSee below
WebhooksHTTP POST requests with JSON, Slack, or Discord formattingWebhook guide
S3Store notifications in AWS S3 bucketsS3 guide
JiraAutomatically create Jira issues from alertsJira guide
LinearAutomatically create Linear issues from alertsLinear guide

Email notifications

Email is a built-in destination type. When configuring an email destination, you can:

  • Notify all team members (including future members) - every user on your team receives the notification
  • Select individual team members - choose specific users from your team
  • Add external email addresses - forward notifications to addresses outside your team (e.g., a ticketing system or SIEM)

You can combine these options - for example, notify all team members and also forward to your SIEM.

Integrations

Some destinations (Jira, Linear) require a team integration to be connected before they can be used as destinations:

  1. Go to Team Settings > Integrations
  2. Click Connect next to the service (Jira or Linear)
  3. Follow the OAuth authorization flow
  4. Once connected, the destination becomes available in your notification configs
Availability

Jira and Linear destinations are included on the Enterprise plan and available as an add-on for Business plans. Contact sales to learn more.

Testing notifications

You can test your notification configs in two ways:

  • Save & Test - when creating or editing a config, click Save & Test to save the config and send a test notification to all destinations
  • Test existing config - from the notification config list, trigger a test for any saved config

Test notifications are clearly marked so your team knows no action is required.

Managing notification configs

All notification configs for your team are listed under Team Settings > Notifications. From there you can:

  • Create new configs with the Create Notification Config button
  • Edit existing configs to change triggers, domains, or destinations
  • Delete configs you no longer need
  • Enable or disable configs without deleting them

All changes are recorded in your team’s audit logs.

Was this page helpful?