---
title: "Create one or more new units groups."
method: POST
path: "/v1/{facility_id}/unit_groups"
tags: ["api-v1-unit_groups"]
---

# Create one or more new units groups.

`POST /v1/{facility_id}/unit_groups`

## Discussion
### This endpoint is only available if the facility has custom unit groups enabled.

This endpoint can create multiple empty unit groups at once by providing a `unit_groups` array of objects with the `name` parameter.

Common errors that may be encountered:
- Unit groups must have unique names across the facility. If non-unique names are provided or names conflict with any existing unit group, a list of errors will be returned under `'errors'` -> `'name_assignments'`.

## Path parameters

- `facility_id` number, required

## Request body

- ApiV1UnitGroupsControllerCreateInput
  - `unit_groups` string[], required — Array of Unit Group names

## Response `200`

ok

---

[API](https://skmtc.dev/storedgefms/apis/storable-edge-api-params-in-body.md) · [All operations](https://skmtc.dev/storedgefms/apis/storable-edge-api-params-in-body/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/storedgefms/storable-edge-api-params-in-body/revisions/50fea30c1954/schema)