Status Page Subscriptions

Let customers subscribe to status updates.

Subscription Types

Email Subscriptions

Customers enter their email to receive updates when:

• A component status changes
• An incident is created or updated
• Scheduled maintenance is announced

Webhook Subscriptions

Developers can subscribe a webhook URL to receive:

• JSON payloads for all status changes
• Programmatic integration with their systems

Enabling Subscriptions

1. Edit your status page settings
2. Enable subscription options:
   • Allow Email Subscriptions: Show email signup form
   • Allow Webhook Subscriptions: Show webhook signup form
3. Save changes

Email Notifications

What Subscribers Receive

• Status Change: When any component status changes
• Incident Updates: New incidents and updates
• Resolution: When incidents are resolved

Email Content

Subject: [Pingward] API - Major Outage

Component: API
Status: Major Outage
Time: January 24, 2024 3:30 PM UTC

We are investigating issues with the API.
Updates will be posted as available.

View full status: https://status.yourcompany.com/acme
Unsubscribe: https://...

Confirmation Flow

1. Customer enters email
2. Confirmation email is sent
3. Customer clicks confirmation link
4. Subscription is activated

This prevents spam signups.

Webhook Notifications

Payload Format

{
  "event": "component.status_changed",
  "timestamp": "2024-01-24T15:30:00Z",
  "statusPage": {
    "slug": "acme",
    "companyName": "Acme Corp"
  },
  "component": {
    "displayName": "API",
    "previousStatus": "operational",
    "currentStatus": "major_outage"
  }
}

Event Types

Event	Description
component.status_changed	Component status changed
incident.created	New incident created
incident.updated	Incident was updated
incident.resolved	Incident was resolved

Webhook Requirements

Subscriber webhooks must:

• Accept POST requests
• Return 2xx status code
• Respond within 30 seconds
• Handle duplicate deliveries

Managing Subscribers

View subscriber counts in the status page settings:

Email Subscribers: 142
Webhook Subscribers: 3

Individual subscriber management is available in the admin panel.

Unsubscribing

Email

Every email includes an unsubscribe link. Clicking it immediately removes the subscription.

Webhook

Webhooks can be removed by:

1. The subscriber visiting their management link
2. Returning 410 Gone to deliveries
3. Admin removal

Best Practices

Encourage Subscriptions

Add a call-to-action:

"Subscribe to get notified when status changes"

Send Relevant Updates

Don't overwhelm subscribers:

• Only notify on actual status changes
• Avoid frequent flapping notifications
• Consolidate rapid changes

Respect Privacy

• Don't share subscriber emails
• Honor unsubscribe requests immediately
• Be transparent about what you'll send