---
title: "Create the user group."
method: POST
path: "/users/{userId}/groups"
tags: ["Users", "Groups"]
---

# Create the user group.

`POST /users/{userId}/groups`

Create the user group.

## Request body

- GroupCreateJson — unresolved $ref

## Response `201`

The entity was created.

## Other responses

- `400` — The request was malformed.
- `401` — Authentication information is missing or invalid
- `403` — The operation is not allowed by current user.
- `404` — The Resource could not be found.
- `5XX` — An internal server error occurred.

## Changes

- **2021-12-14** `d99002381381` — 1 breaking, 1 info
  - request body became required
  - added the media type `application/json` to the request body
- **2021-12-14** `41dac4f34d9e` — 1 info
  - endpoint added
- **2021-12-07** `9e60f373a1f0` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/envirocar/apis/envirocar-rest-api/changes/users/:userId/groups/post.md)

---

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