> ## Documentation Index
> Fetch the complete documentation index at: https://docs.larm.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Create status page

> Creates a new status page

Requires `status_pages:read_write` permission.

Creates the page itself. To add components and groups, use the [Components](/api-reference/components/create) and [Component groups](/api-reference/component-groups/create) endpoints, or replace the entire structure in one call with [PUT structure](/api-reference/status-pages/structure).

<ParamField body="name" type="string" required>
  Page name (1–255 characters)
</ParamField>

<ParamField body="slug" type="string" required>
  URL identifier (3–63 characters, lowercase alphanumeric and hyphens; cannot start or end with a hyphen)
</ParamField>

<ParamField body="description" type="string">
  Brief description (up to 1000 characters)
</ParamField>

<ParamField body="theme" type="string" default="system">
  `system`, `light`, or `dark`
</ParamField>

<ParamField body="primary_color" type="string">
  Brand color in hex format (e.g. `#4F46E5`)
</ParamField>

<ParamField body="logo_light_url" type="string">
  URL of the logo to use on light backgrounds
</ParamField>

<ParamField body="logo_dark_url" type="string">
  URL of the logo to use on dark backgrounds
</ParamField>

<ParamField body="show_theme_switcher" type="boolean" default={false}>
  Show a light/dark theme switcher on the public page
</ParamField>

<ParamField body="enabled" type="boolean" default={false}>
  Whether the page is publicly visible
</ParamField>

<ParamField body="subscribers_enabled" type="boolean" default={false}>
  Allow email subscriptions
</ParamField>

<ResponseExample>
  ```json 201 theme={null}
  {
    "data": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Acme Status",
      "slug": "acme",
      "description": "Current status of Acme services",
      "theme": "system",
      "primary_color": null,
      "enabled": true,
      "subscribers_enabled": false,
      "custom_domain": null,
      "domain_status": "none",
      "logo_light_url": null,
      "logo_dark_url": null,
      "url": "https://acme.status.larm.dev",
      "components": [],
      "inserted_at": "2025-03-01T12:00:00Z",
      "updated_at": "2025-03-01T12:00:00Z"
    }
  }
  ```
</ResponseExample>