---
title: "Create a status page"
method: POST
path: "/page"
tags: ["page"]
---

# Create a status page

`POST /page`

## Request body

- object
  - `title` string, required — The title of the page
  - `description` string, required — The description of the page
  - `slug` string, required — The slug of the page
  - `customDomain` string, nullable — The custom domain of the page. To be configured within the dashboard.
  - `icon` union — The icon of the page
    - string, uri
    - ''
    - unknown
  - `passwordProtected` boolean — Deprecated in favor of `accessType`. Used to set the password protection type. Returns true if `accessType` is set to 'password' and false otherwise.
  - `accessType` 'public' | 'password' | 'email-domain' — The access type of the page
  - `password` string, nullable — Your password to protect the page from the public
  - `authEmailDomains` string[], nullable — The email domains of the page
  - `showMonitorValues` boolean, nullable — Displays the total and failed request numbers for each monitor. Deprecated and will be removed in the future in favor for `configuration` property.
  - `monitors` union
    - number[] — The monitors of the page as an array of ids. We recommend using the object format to include the order.
    - object[] — The monitor as object allowing to pass id and order
      - `monitorId` number, required
      - `order` number, required

## Response `200`

Get an Status page

- Page
  - `id` number, required — The id of the page
  - `title` string, required — The title of the page
  - `description` string, required — The description of the page
  - `slug` string, required — The slug of the page
  - `customDomain` string, nullable — The custom domain of the page. To be configured within the dashboard.
  - `icon` union — The icon of the page
    - string, uri
    - ''
    - unknown
  - `passwordProtected` boolean — Deprecated in favor of `accessType`. Used to set the password protection type. Returns true if `accessType` is set to 'password' and false otherwise.
  - `accessType` 'public' | 'password' | 'email-domain' — The access type of the page
  - `password` string, nullable — Your password to protect the page from the public
  - `authEmailDomains` string[], nullable — The email domains of the page
  - `showMonitorValues` boolean, nullable — Displays the total and failed request numbers for each monitor. Deprecated and will be removed in the future in favor for `configuration` property.
  - `monitors` union
    - number[] — The monitors of the page as an array of ids. We recommend using the object format to include the order.
    - object[] — The monitor as object allowing to pass id and order
      - `monitorId` number, required
      - `order` number, required

## Other responses

- `400` — The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing).
- `401` — The client must authenticate itself to get the requested response.
- `402` — A higher pricing plan is required to access the resource.
- `403` — The client does not have the necessary permissions to access the resource.
- `404` — The server can't find the requested resource.
- `409` — The request could not be completed due to a conflict mainly due to unique constraints.
- `500` — The server has encountered a situation it doesn't know how to handle.

---

[API](https://skmtc.net/openstatus/apis/openstatus-api.md) · [All operations](https://skmtc.net/openstatus/apis/openstatus-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openstatus/openstatus-api/revisions/f075fbb509f7/schema)