PulsAPI Logo
PulsAPI Docs

Notification Preferences

Control how many notifications you receive per service with granular notification levels and review your notification history.

Notification Preferences

While alert rules define when notifications fire and channels define where they go, notification preferences let you control how much you hear about each individual service.

Notification levels

Every service you subscribe to has a notification level. The default level is ALL unless you change it.

LevelWhat you receive
ALLEvery status change — Degraded, Partial Outage, Major Outage, and recovery back to Operational.
MAJOR_ONLYOnly Partial Outage and Major Outage transitions (plus recovery). Minor degradations are suppressed.
OUTAGES_ONLYOnly Major Outage transitions and recovery. Partial outages and degradations are suppressed.
CRITICAL_ONLYOnly Major Outage when the severity is Critical (as defined by your alert rules). Recovery notifications are included.
NONENo notifications for this service. The service still appears on your dashboard and its status is tracked — you simply are not alerted.

Use MAJOR_ONLY or OUTAGES_ONLY for services that frequently show brief degradations you do not need to act on. This keeps your inbox and Slack channel focused on real incidents.

Setting preferences for a service

From the service detail page

  1. Open the service by clicking its name on the dashboard or in the service directory.
  2. Click the Notifications tab.
  3. Select a notification level from the dropdown.
  4. Click Save.

From the settings page

  1. Go to Dashboard → Settings → Notification Preferences.
  2. You will see a table listing every service you subscribe to along with its current notification level.
  3. Click the level dropdown next to any service and choose a new level.
  4. Changes are saved automatically.

Notification preferences are per-user. If you are on a team, each member can set their own preferences independently.

Bulk editing preferences

To change the notification level for many services at once:

  1. Go to Dashboard → Settings → Notification Preferences.
  2. Use the checkboxes to select multiple services (or click Select All).
  3. Click the Set Level button that appears above the table.
  4. Choose the desired level from the dropdown.
  5. Click Apply. All selected services are updated.

In-app notifications

PulsAPI includes an in-app notification popover accessible via the bell icon in the top navigation bar.

  • A red badge shows the count of unread notifications.
  • Click the bell to open the popover and see recent alerts.
  • Each notification shows the service name, new status, severity, and timestamp.
  • Click Mark as Read on individual items or Mark All as Read at the top.
  • Click a notification to navigate directly to the service detail page.

Notification history

The notification history log records every notification PulsAPI has attempted to deliver.

Accessing history

  1. Navigate to Dashboard → Alerts → History.
  2. The table shows all notifications sorted by most recent.

Understanding delivery states

StateMeaning
SentThe notification was delivered successfully to the channel.
PendingThe notification is queued and waiting for delivery (usually resolves within seconds).
FailedDelivery failed after all retry attempts. Hover over the status to see the error details.

Acknowledging notifications

You can acknowledge notifications to track which incidents your team has reviewed:

  1. In the history table, click the Acknowledge button next to any notification.
  2. The notification is marked with your name and a timestamp.
  3. Use the Filter dropdown to show only unacknowledged notifications for triage.

Acknowledged notifications are visible to all team members, making it easy to see who has already reviewed an incident.

Filtering and searching history

Use the controls at the top of the history table to narrow results:

FilterOptions
StatusSent, Pending, Failed
ChannelEmail, Slack, Discord, Webhook
ServiceAny subscribed service
Date rangeCustom start and end date
AcknowledgedYes / No