# 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`.

[endpoint]
method = "POST"
base_url = "https://uptime.betterstack.com"
path = "/api/v2/status-pages/{status_page_id}/subscribers"

[[path_param]]
name = "status_page_id"
type = "string"
required = true
description = "The ID of your status page."

[[header]]
name = "Authorization"
type = "string"
required = true
description = "Bearer `$TOKEN`"

[[header]]
name = "Content-Type"
type = "string"
required = false
description = "application/json"

[[body_param]]
name = "email"
type = "string"
required = true
description = "The subscriber email address."

[[body_param]]
name = "status_page_resource_ids"
type = "array"
required = false
default = "[]"
description = "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`."
[/endpoint]

[responses]
[[response]]
status = 201
description = "Returns a newly created status page subscriber."
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"
    }
  }
}
'''
[/responses]

#### Example cURL

```bash
[label 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": []
  }'
```

```bash
[label 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](https://betterstack.com/docs/uptime/api/status-pages-subscribers-api-response-params/).