---
title: "Add a new group"
method: POST
path: "/v1/workspaces/{workspaceId}/user-groups"
tags: ["Group"]
---

# Add a new group

`POST /v1/workspaces/{workspaceId}/user-groups`

## Path parameters

- `workspaceId` string, required — Represents a workspace identifier across the system.

## Request body

- UserGroupRequest
  - `name` string — Represents a user group name.

## Response `201`

Created

- UserGroupDtoV1
  - `id` string — Represents a user group identifier across the system.
  - `name` string — Represents a user group name.
  - `teamManagers` UserRedactedDtoV1[] — Represents a list of assigned team managers for this user group.
    - `id` string
    - `name` string
  - `userIds` string[] — Represents a list of users' identifiers across the system.
  - `workspaceId` string — Represents a workspace identifier across the system.

---

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