Subscriber Notifications
Subscribers are clients or end users who opt in to receive notifications when your service status changes. The One Status supports email and SMS notifications with configurable frequency and component-level filtering.
How Clients Subscribe
On any public status page (with subscriptions enabled), visitors see a Subscribe to Updates button or form.
- The visitor enters their email address (and optionally a phone number for SMS)
- Selects which channels to use: Email, SMS, or both
- Optionally selects specific components to follow (default: all components)
- Optionally sets notification frequency (default: immediate)
- Clicks Subscribe
- Receives a confirmation email — they must click the confirmation link to activate
Until the confirmation link is clicked, the subscriber is pending and will not receive notifications.
Notification Channels
| Channel | Description |
|---|---|
| Notifications sent to the subscriber's email address | |
| SMS | Notifications sent to the subscriber's phone number via SMS |
| Webhook | Outbound HTTP POST to a URL the subscriber provides (for technical integrations) |
Notification Triggers
Subscribers receive a notification for each of the following events:
| Event | Who Gets Notified |
|---|---|
| Incident created | All subscribers for affected components (or all subscribers if no components specified) |
| Incident updated (status change + new message) | All subscribers for affected components |
| Incident resolved | All subscribers for affected components |
| Maintenance scheduled | All subscribers for affected components |
| Maintenance started | All subscribers for affected components |
| Maintenance completed | All subscribers for affected components |
| Component status changed (via automated monitoring) | Subscribers following that component |
Notification Frequency Options
Subscribers choose how often they receive notifications:
| Frequency | Behavior |
|---|---|
| Immediate | Notified as soon as each event occurs |
| Daily Digest | One summary email/SMS at 9:00 AM UTC covering all events from the previous 24 hours |
| Weekly Digest | One summary email/SMS on Monday at 9:00 AM UTC covering all events from the past week |
Component-Level Subscriptions
Subscribers can choose to follow only specific components rather than the whole page. For example, a client who only uses your help desk might subscribe only to the "Help Desk" component.
- Subscribers following all components get notified for any component event
- Subscribers following specific components only get notified for events involving those components
- If an incident has no affected components listed, all subscribers are notified
Managing Subscription Preferences
Each subscriber receives a unique preferences link in every notification email. Clicking it opens the Subscriber Preferences page where they can:
- Change which components they follow
- Change notification frequency
- Add or remove channels
- Unsubscribe from all notifications
The preferences page is available at: https://app.theonestatus.app/preferences/{token}
Unsubscribing
Every notification includes an Unsubscribe link. Clicking it immediately deactivates the subscription. Unsubscribed users stop receiving all notifications for that status page.
To resubscribe, a user must visit the public status page and subscribe again.
Managing Subscribers as an Admin
In the Subscribers tab on any status page:
- View all confirmed and pending subscribers
- See total subscriber count
- Filter by confirmed/pending status
- Delete individual subscribers (removes them immediately; they stop receiving notifications)
Subscriber Statistics
The Subscribers tab shows aggregate stats:
- Total subscribers — count of confirmed subscribers
- Pending subscribers — count who haven't confirmed their email yet
- Breakdown by channel (email vs SMS)
Notification Content
Email Notifications
Incident notification emails include:
- Status page name and link
- Incident title and current status
- Severity/impact level
- Current update message
- Link to view the full incident on the public page
- Unsubscribe link
SMS Notifications
SMS notifications are brief due to character limits:
- Status page name
- Incident title and new status
For maintenance notifications, the scheduled start time is included.
Incident-Only Mode
Subscribers can optionally select Incidents Only in their preferences. This means they receive notifications for incidents but not for maintenance windows or component status changes from automated monitoring.
Webhook Subscriber Notifications
Subscribers can also subscribe via webhook — providing an HTTP endpoint URL to receive structured JSON payloads for each event. This is designed for automated integrations (e.g., posting to Slack, creating a ticket in PSA).
See Webhooks for the full webhook payload format and setup.