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

# Create a status page

`POST /v1/status-pages`

## Request

- Base URL: `https://api.merlonix.com`
- URL: `https://api.merlonix.com/v1/status-pages`
- Auth: HTTP bearer

Create a public status page for a client. Requires a `write`-scoped key. The free tier is capped at one status page (`402` beyond it); paid tiers allow one page per client. Add components, incidents, and subscribers through the dashboard sub-resources.

## Request body

- StatusPageCreate: Request body for creating a status page (TD-943).
  - `client_id` string, uuid, required: The client this status page belongs to.
  - `title` string: Display title; defaults from the client name.
  - `slug` string: URL-safe slug; derived when omitted. Unique per tenant.

## Response `201`

The created status page.

- StatusPage
  - `id` string, uuid, required
  - `tenant_id` string, uuid, required
  - `client_id` string, uuid, required
  - `slug` string, required
  - `title` string, required
  - `is_public` boolean, required
  - `show_uptime` boolean, required
  - `list_in_public_directory` boolean, required
  - `custom_domain` string, nullable, required
  - `display_timezone` string, nullable, required
  - `component_count` integer, required
  - `public_url` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400`: Error — canonical envelope with a trace_id.
- `401`: Error — canonical envelope with a trace_id.
- `402`: Error — canonical envelope with a trace_id.
- `403`: Error — canonical envelope with a trace_id.
- `404`: Error — canonical envelope with a trace_id.
- `409`: Error — canonical envelope with a trace_id.
- `429`: Error — canonical envelope with a trace_id.

---

[API](https://skmtc.dev/merlonix/apis/merlonix-public-api.md) · [All operations](https://skmtc.dev/merlonix/apis/merlonix-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/merlonix/apis/merlonix-public-api/revisions/2192584bdfcd?raw)