---
title: "Create a status page"
method: POST
path: "/api/status-pages"
tags: ["Status Pages"]
---

# Create a status page

`POST /api/status-pages`

## Request

- Base URL: `https://demo.supercheck.dev`
- URL: `https://demo.supercheck.dev/api/status-pages`
- Auth: HTTP bearer

Create a status page in the current project. Requires `status_page:create`. The page starts as a `draft` and its `subdomain` is generated by the server; sending `subdomain` or `customDomainVerified` returns 400. Unknown body fields are rejected. If your account allows it, creation succeeds; otherwise a 403 explains the limit that was reached. A 429 means too many concurrent create requests - retry shortly.

## Request body

- object
  - `name` string, required
  - `headline` string
  - `pageDescription` string

## Response `201`

Created status page

- object
  - `statusPage` StatusPage
    - `id` string, uuid
    - `name` string
    - `subdomain` string
    - `status` string
    - `pageDescription` string, nullable
    - `allowRssFeed` boolean
    - `faviconLogo` string, nullable
    - `transactionalLogo` string, nullable
    - `heroCover` string, nullable
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable

## Other responses

- `400`: Invalid body, or a server-managed field was sent
- `401`: Authentication required or token invalid
- `403`: Insufficient permissions, or the number of status pages your account allows has been reached
- `429`: Too many concurrent requests
- `500`: Failed to create status page

## Changes

- **2026-10-25** `9d4e9599f8c5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/supercheck-io/apis/supercheck-api/changes/api/status-pages/post.md)

---

[API](https://skmtc.dev/supercheck-io/apis/supercheck-api.md) - [All operations](https://skmtc.dev/supercheck-io/apis/supercheck-api/llms.txt) - [OpenAPI document](https://skmtc.dev/supercheck-io/apis/supercheck-api/revisions/7fa0162c07bd?raw)