> ## 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 component group

> Creates a new component group on a status page

Requires `status_pages:read_write` permission. Component groups render as collapsible headings on the public status page.

<ParamField path="status_page_id" type="string" required>
  Status page UUID
</ParamField>

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

<ParamField body="position" type="integer" default={0}>
  Display position (0-indexed) within the page
</ParamField>

<ResponseExample>
  ```json 201 theme={null}
  {
    "data": {
      "id": "880e8400-e29b-41d4-a716-446655440000",
      "name": "Backend",
      "position": 0,
      "inserted_at": "2025-03-01T12:00:00Z",
      "updated_at": "2025-03-01T12:00:00Z"
    }
  }
  ```
</ResponseExample>