---
title: "Create camera group"
method: POST
path: "/v1/camera-groups"
tags: ["camera-groups"]
---

# Create camera group

`POST /v1/camera-groups`

Create a new camera group.

Create a new camera group with the specified name. Camera groups are used
to organize cameras for easier management and access control.

## Request body

- CreateCameraGroupPayload — Request payload for creating a camera group.
  - `name` string, required — Display name for the new camera group (max 30 characters)

## Response `200`

Successful Response

- CreateCameraGroupResponse — Response after successfully creating a camera group.
  - `data` CameraGroup, required — A logical grouping of cameras for organization and access control.
    - `id` integer, required — Unique camera group identifier
    - `name` string, required — Camera group display name

## Other responses

- `400` — Camera group creation failed
- `403` — Unauthorized
- `409` — Camera group name already exists
- `422` — Validation error

---

[API](https://skmtc.dev/coram/apis/coram-api.md) · [All operations](https://skmtc.dev/coram/apis/coram-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coram/coram-api/revisions/2842f226f93b/schema)