Explore documentation
  1. Welcome to Uptime 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Connecting external calendars
    4. Advanced guide
  4. Incidents
    1. Get started
    2. Post mortems
    3. Metadata & Catalog
    4. Screening alerts
    5. Reporting ↗
  5. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Uptime API
    1. Getting an API token
    2. Monitors
    3. Heartbeats
    4. On-call & incidents
    5. Status pages
      1. Status pages API
      2. Status page groups
      3. Status page sections
      4. Status page resources
      5. Status page subscribers
        1. List status page subscribers GET
        2. Get status page subscriber GET
        3. Create status page subscriber POST
        4. Update status page subscriber PATCH
        5. Remove status page subscriber DELETE
        6. Response attributes
      6. Status page reports
      7. Status page report updates
    6. Metadata
    7. Integrations
    8. Team members

Create status page subscriber

Creates a confirmed email subscriber for a status page.

Creating a subscriber who previously unsubscribed subscribes that email again. Creating an email address that is already actively subscribed returns 422.

POST https://uptime.betterstack.com/api/v2/status-pages/{status_page_id}/subscribers

URL parameters

status_page_id
required string

The ID of your status page.

Headers

Authorization
required string

Bearer $TOKEN

Content-Type
string

application/json

Body parameters

email
required string

The subscriber email address.

status_page_resource_ids
[] array

The status page resources this subscriber receives updates for. Use [] for all resources. Get valid resource IDs from GET /api/v2/status-pages/{status_page_id}/resources.

201

Returns a newly created status page subscriber.

Response body

{
  "data": {
    "id": "123456789",
    "type": "status_page_subscriber",
    "attributes": {
      "status_page_id": 987654321,
      "email": "customer@example.com",
      "status_page_resource_ids": [],
      "confirmed_at": "2026-04-29T14:30:00.000Z",
      "created_at": "2026-04-29T14:30:00.000Z",
      "updated_at": "2026-04-29T14:30:00.000Z"
    }
  }
}

Example cURL

Subscribe to all resources
curl --request POST \
  --url https://uptime.betterstack.com/api/v2/status-pages/987654321/subscribers \
  --header "Authorization: Bearer $TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "email": "customer@example.com",
    "status_page_resource_ids": []
  }'


Subscribe to specific resources
curl --request POST \
  --url https://uptime.betterstack.com/api/v2/status-pages/987654321/subscribers \
  --header "Authorization: Bearer $TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "email": "customer@example.com",
    "status_page_resource_ids": [112233, 112234]
  }'


Looking for the details of a specific parameter?

Explore the list of all status page subscriber API parameters.

Previous article

Get status page subscriber

Next article

Update status page subscriber