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
      3. Status page sections
        1. List status page sections GET
        2. Get status page section GET
        3. Create status page section POST
        4. Update status page section PATCH
        5. Remove status page section DELETE
      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 section

Returns a newly created status page section.

POST https://incidents.betterstack.com/api/v2/status-pages/{status_page_id}/sections

URL parameters

status_page_id
required string

The ID of your status page

Headers

Authorization
required string

Bearer $TOKEN

Content-Type
string

application/json

Body parameters

name
string

The name of the section. Leave blank to hide the section header.

position
integer

The position of this section on your status page, counted from the top and indexed from zero. If you don't specify a position, we add the section to the end of the status page. When you specify the position of an existing section, we add the section at this position and shift the sections below to accommodate.

fixed_position
boolean

If true, the section is saved at exactly position and the other sections keep their positions. Defaults to false.

201

Response body

{
  "data": {
    "id": "12345",
    "type": "status_page_section",
    "attributes": {
      "name": "EU Datacenter",
      "position": 0,
      "status_page_id": 123456789
    }
  }
}

Example cURL

Example
curl --request POST \
  --url https://incidents.betterstack.com/api/v2/status-pages/123456789/sections \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "EU Datacenter",
    "position": 0
}'


Previous article

Get status page section

Next article

Update status page section