This is an archive of our API documentation. Our new API docs can be found at https://developer.statuspage.io
Full API and Integration Documentation

Subscribers

Subscribers are those that receive notifications via email or sms to incidents that are reported and subsequently updated. Subscribers can reside at the organization level where they get all updates to every incident automatically, or at the incident level where they must opt-in to notifications after the incident has been created.

Get a list of all subscribers
ENDPOINTS
  GET /organizations/[organization_id]/subscribers.json
  GET /organizations/[organization_id]/incidents/[incident_id]/subscribers.json

SAMPLE CALL
  curl https://api.statuspage.io/v0/organizations/qfn30z5r6s5h/subscribers.json \
    -H "Authorization: OAuth 2a7b9d4aac30956d537ac76850f4d78de30994703680056cc103862d53cf8074"

RESPONSE CODES
  200 - Successful call

SAMPLE RESPONSE
  [
    {
      "created_at": "2013-03-05T20:50:42Z",
      "id": "f6c6ggw8z0t1",
      "phone_country": "us",
      "phone_number": "9196022733"
    },
    {
      "created_at": "2013-03-05T20:50:42Z",
      "email": "steve@flyingkleinbrothers.com",
      "id": "xx5tcn6g80n8"
    },
    {
      "created_at": "2013-03-05T20:50:42Z",
      "email": "scott@flyingkleinbrothers.com",
      "id": "pm0tzg6pwkr4"
    }
  ]
Create a subscriber

You must be provide either subscriber[email], both of subscriber[phone_country] and subscriber[phone_number], or both of subscriber[email] and subscriber[endpoint].

A list of supported SMS countries can be found at https://api.statuspage.io/sms_countries.json

ENDPOINTS
  POST /organizations/[organization_id]/subscribers.json
  POST /organizations/[organization_id]/incidents/[incident_id]/subscribers.json

ATTRIBUTES
  subscriber[email] - The email address the subscriber wishes to receive notifications at (or, confirmation for webhook endpoint)
  subscriber[phone_number] - The phone number the subscriber wishes to receive notifications at
  subscriber[phone_country] - The two digit country code corresponding to the phone country
  subscriber[endpoint] - The URL endpoint you wish to wish to receive webhook notifications at (must be accompanied by email)

SAMPLE CALL
  curl https://api.statuspage.io/v0/organizations/qfn30z5r6s5h/subscribers.json \
    -H "Authorization: OAuth 2a7b9d4aac30956d537ac76850f4d78de30994703680056cc103862d53cf8074" \
    -X POST \
    -d "subscriber[email]=scott@scottkle.in"
    

RESPONSE CODES
  201 - Successfully created
  422 - Validation failed (see errors in response body)

SAMPLE RESPONSE
  {
    "created_at": "2013-03-05T23:57:39Z",
    "email": "scott@scottkle.in",
    "id": "86z91fzjhlxy"
  }
Delete a subscriber
ENDPOINT
  DELETE /organizations/[organization_id]/subscribers/[subscriber_id].json
  DELETE /organizations/[organization_id]/incidents/[incident_id]/subscribers/[subscriber_id].json

SAMPLE CALL
  curl https://api.statuspage.io/v0/organizations/qfn30z5r6s5h/subscribers/86z91fzjhlxy.json \
    -H "Authorization: OAuth 2a7b9d4aac30956d537ac76850f4d78de30994703680056cc103862d53cf8074" \
    -X DELETE
    

RESPONSE CODES
  200 - Successful call
  422 - Validation failed (see errors in response body)

SAMPLE RESPONSE
  {
    "created_at": "2013-03-05T23:57:39Z",
    "email": "scott@scottkle.in",
    "id": "86z91fzjhlxy"
  }