> ## 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](https://docs.larm.dev/api-reference/components/create.md) and [Component groups](https://docs.larm.dev/api-reference/component-groups/create.md) endpoints, or replace the entire structure in one call with [PUT structure](https://docs.larm.dev/api-reference/status-pages/structure.md).

**name** `string` *required*

Page name (1–255 characters)

**slug** `string` *required*

URL identifier (3–63 characters, lowercase alphanumeric and hyphens; cannot start or end with a hyphen)

**description** `string`

Brief description (up to 1000 characters)

**theme** `string` (default: system)

`system`, `light`, or `dark`

**primary\_color** `string`

Brand color in hex format (e.g. `#4F46E5`)

**logo\_light\_url** `string`

URL of the logo to use on light backgrounds

**logo\_dark\_url** `string`

URL of the logo to use on dark backgrounds

**show\_theme\_switcher** `boolean` (default: false)

Show a light/dark theme switcher on the public page

**enabled** `boolean` (default: false)

Whether the page is publicly visible

**subscribers\_enabled** `boolean` (default: false)

Allow email subscriptions

```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"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.