---
title: "Add new group"
method: POST
path: "/groups/"
tags: ["groups"]
---

# Add new group

`POST /groups/`

This method creates a groups object.
 **Groups** are objects used to control access to the system entities, such as watch lists, camera groups, etc.

## Request body

- GroupRequest
  - `name` string, required
  - `permissions` string[]
  - `ad_group` GroupGuidRequest
    - `group_guid` string, uuid, nullable, required

## Response `201`

- Group
  - `id` integer, required
  - `name` string, required
  - `permissions` string[]
  - `ad_group` GroupGuid
    - `group_guid` string, uuid, nullable, required

---

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