Explore documentation
  1. Welcome to Uptime 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Sending alerts to Slack ↗
    3. Connecting external calendars
    4. Advanced guide
  4. Incidents
    1. Get started
    2. Advanced guide
  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. Uptime API
    1. Getting an API token
    2. Monitors
    3. Heartbeats
    4. On-call & incidents
    5. 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
        7. Response attributes
      3. Status page sections
      4. Status page resources
      5. Status page reports
      6. Status page report updates
    6. Metadata
    7. Integrations

Create status page group

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

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

Headers

Authorization
required string

Bearer $TOKEN

Content-Type
string

application/json

Body parameters

team_name
string

Required if using a global API token to specify the team which should own the resource.

name
string

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

sort_index
integer

Set sort_index to specify how to sort your status page groups.

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",
      "team_name": "Test Team"
    }
  }
}

Example cURL

Example
curl --request POST \
  --url https://uptime.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