Explore documentation
  1. Welcome to Incidents 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Tag on-call in Slack
    4. Mobile apps ↗
    5. Connecting external calendars
    6. Advanced guide
  4. Incident management
    1. Get started
    2. AI SRE investigations
    3. Post mortems
    4. Metadata & Catalog
    5. Screening alerts
    6. 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. Incidents API
    1. Getting an API token
    2. Pagination
    3. Monitors
    4. Heartbeats
    5. On-call & incidents
    6. Status pages
      1. Status pages API
      2. Status page groups
        1. List status page groups GET
        2. Get status page group GET
        3. List status pages in group GET
        4. Create status page group POST
        5. Update status page group PATCH
        6. Remove status page group DELETE
      3. Status page sections
      4. Status page resources
      5. Status page subscribers
      6. Status page reports
      7. Status page report updates
    7. Metadata
    8. Integrations
    9. Team members
    10. Organization roles
    11. Usage
    12. Reporting

Create status page group

Returns either a newly created status page group, or validation errors.

POST https://incidents.betterstack.com/api/v2/status-page-groups

Headers

Authorization
required string

Bearer $TOKEN

Content-Type
string

application/json

Body parameters

name
required string

A name for the group that you can see in the dashboard.

sort_index
integer

The position of the group in your list of status page groups, lower values first. Defaults to null. position is accepted as an alias.

201

Returns a newly created status page group.

Response body

{
  "data": {
    "id": "1372980",
    "type": "status_page_group",
    "attributes": {
      "name": "Production Status Pages",
      "sort_index": 1,
      "created_at": "2024-11-08T10:00:00.000Z",
      "updated_at": "2024-11-08T10:00:00.000Z"
    }
  }
}

Example cURL

Example
curl --request POST \
  --url https://incidents.betterstack.com/api/v2/status-page-groups \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Production Status Pages",
  "sort_index": 1
}'


Previous article

List status pages in a group

Next article

Update status page group