Managing Subscribers
Subscribers receive notifications about incidents and maintenance windows.
Subscription Types
| Type | Description |
|---|---|
| Receives notifications via email | |
| SMS | Receives notifications via text message |
Each subscriber has one type. Users who want both should create two subscriptions.
Adding Subscribers
Manual Addition
- Go to Notifications → Subscribers
- Click Create New
- Fill in:
- Type - Email or SMS
- Email - Email address (for email type)
- Phone - Phone number with country code (for SMS type)
- Verified - Whether the subscription is verified
- Active - Whether to send notifications
- Click Save
Public Subscription
Users can subscribe via the public status page:
- Click the “Subscribe” button on the status page
- Enter their email or phone number
- They appear in the Subscribers list
Subscriber Fields
| Field | Description |
|---|---|
| Type | Email or SMS |
| Email address (for email subscribers) | |
| Phone | Phone number with country code (for SMS) |
| Verified | Whether the subscription is verified |
| Active | Whether to receive notifications |
| Verification Token | Auto-generated token for verification |
| Unsubscribe Token | Auto-generated token for unsubscribe links |
Active vs Inactive
- Active - Subscriber will receive notifications
- Inactive - Subscriber will NOT receive notifications
Subscribers become inactive when:
- They click the unsubscribe link in an email
- An admin manually deactivates them
Unsubscribe Flow
Each email includes an unsubscribe link:
https://status.example.com/unsubscribe/{token}
When clicked:
- User sees a confirmation message
- Subscription is set to inactive
- They no longer receive notifications
The unsubscribe link is unique per subscriber and doesn’t expire.
Phone Number Format
SMS phone numbers must include the country code:
- ✅
+14155551234(US) - ✅
+442071234567(UK) - ✅
+33123456789(France) - ❌
415-555-1234(missing country code) - ❌
(415) 555-1234(missing country code)
Verification
The Verified field indicates whether the email/phone has been confirmed.
For manually added subscribers, you can set this to true if you’ve verified the contact information.
Bulk Operations
To deactivate multiple subscribers:
- Select subscribers in the list view
- Use bulk actions to update
Privacy Considerations
- Store only necessary contact information
- Provide easy unsubscribe options
- Respect unsubscribe requests immediately
- Consider data retention policies