Keep your users informed about service status by allowing them to subscribe to updates. Better Stack supports multiple ways to access status information: e-mail subscriptions, webhooks, RSS feeds, and a JSON API.

E-mail subscriptions

Users receive e-mail notifications when incidents occur, maintenance is scheduled, or status updates are posted. Subscribers can choose to receive updates for all services or specific components only.

Learn more about e-mail subscriptions

Webhook subscriptions

Receive automated HTTP POST requests whenever there's a status update. Perfect for integrating status updates into your own systems, sending notifications to Slack, or triggering automated workflows.

Learn more about webhook subscriptions

RSS feeds

Access your status page updates through an RSS feed. Users can add the feed to their RSS reader to stay informed without providing an e-mail address.

Learn more about RSS feeds

JSON API

Access your status page data programmatically through a JSON endpoint. Poll the API to retrieve current status, historical uptime data, and incident information for custom dashboards and integrations.

Learn more about the JSON API

Enable subscriptions on your status page

Allow visitors to subscribe to your status page updates.

1. Go to Status pages → select your status page → Advanced settings.
2. Look for the Subscribing to status updates section → Enable Let users subscribe to updates via e-mail and webhook.
3. Save changes.

A subscription button now appears on your status page, allowing visitors to choose their preferred subscription method and subscribe.

Manage subscribers

View and manage all subscribers to your status page.

1. Go to Status pages → select your status page.
2. Click the Subscribers tab.

From here you can:

• View all active subscribers.
• See subscription type for each subscriber, e-mail or webhook.
• View what components users have subscribed to.
• Check subscription status.
• Remove subscribers.

Subscription confirmation

New subscribers must confirm their subscription by clicking a link sent to their e-mail. This prevents spam and ensures subscribers actually want to receive updates.

Webhook subscriptions also require e-mail confirmation. The confirmation e-mail is sent to the contact e-mail provided during webhook setup.

Unsubscribing

Every notification includes an unsubscribe link. Users can instantly unsubscribe by clicking this link without needing to log in or contact support.

Notification triggers

Push notifications for e-mail and webhooks

E-mail and webhook subscribers receive updates when:

• New status page report is created
• Status page updates are posted (ongoing updates to the original report)
• Maintenance windows are scheduled

Subscribers do not receive notifications for:

• Minor status page configuration changes
• Updates to incidents they haven't subscribed to

Troubleshooting

Subscribers not receiving e-mails

1. Check spam and junk folders for confirmation e-mails.
2. Verify the subscriber confirmed their subscription.
3. Check the e-mail address for typos.

Webhook not receiving updates

1. Verify the webhook was confirmed via e-mail.
2. Check your endpoint is accessible and returning 2xx status codes.
3. Ensure your firewall allows requests from Better Stack.