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

Email subscriptions

Users receive email 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 email 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 email 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 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 (email, 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 email. This prevents spam and ensures subscribers actually want to receive updates.

Webhook subscriptions also require email confirmation. The confirmation email is sent to the contact email 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 (email, webhooks)

Email 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 emails

1. Check spam and junk folders for confirmation emails
2. Verify the subscriber confirmed their subscription
3. Check email address for typos

Webhook not receiving updates

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