---
title: "Add Subscriber"
method: POST
path: "/subscriber/add"
tags: ["Subscribers"]
---

# Add Subscriber

`POST /subscriber/add`

Add a new subscriber to receive incident and maintenance notifications.

## Headers

- `x-api-id` string, required
- `x-api-key` string, required

## Request body

- object
  - `statuspage_id` string, required — ID of the status page
  - `method` string, required — Communication method of subscriber. Valid methods are **email**, **sms**, or **webhook**
  - `address` string, required — Subscriber address (SMS numbers must include country code, e.g., +1)
  - `silent` string — Suppress welcome message: 1 = skip, 0 = send
  - `granular` string — Choose which components and data centers to receive notifications for. Comma-separated list of component_container combinations.

## Response `200`

OK

- object
  - `result` boolean
  - `status` object
    - `error` string
    - `message` string
  - `subscriber_id` string

---

[API](https://skmtc.net/status/apis/status-io-api-v2.md) · [All operations](https://skmtc.net/status/apis/status-io-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/status/status-io-api-v2/revisions/6054bf6d1a84/schema)