Subscribe an email address to a status page
POST/api/v1/orgs/:org/status-pages/:statusPageUid/subscribers
PUBLIC, unauthenticated. Double opt-in: a confirmation email is sent and nothing is delivered until its link is followed, which is the primary anti-abuse control.
Email is the ONLY channel available here. A channel of anything else is refused — a visitor pasting a webhook URL has no verification story, and the URL is itself a credential. Webhook and Slack deliveries are registered by an operator through POST .../subscribers/endpoints instead.
Request
Responses
- 202
- 401
- 404
- 422
Accepted. A confirmation email has been sent; nothing is deliverable until it is confirmed.
The status page is password protected and the request carried no valid unlock cookie. The error code is STATUS_PAGE_LOCKED, deliberately distinct from a generic UNAUTHORIZED: it means "unlock me", not "log in" — public status pages have no accounts. Obtain the cookie from POST /api/v1/status-pages/{org}/{slug}/unlock and replay it.
Resource not found
Validation error