---
title: "Create Group"
method: POST
path: "/v2/team/{team_id}/group"
tags: ["User Groups"]
---

# Create Group

`POST /v2/team/{team_id}/group`

This endpoint creates a [User Group](https://docs.clickup.com/en/articles/4010016-teams-how-to-create-user-groups) within a Workspace.\
 \
User Groups are used to organize and manage users within a Workspace.\
 \
In the API documentation, `team_id` refers to the Workspace ID, and `group_id` refers to the User Group ID.\
 \
**Note:** Adding a guest with view-only permissions to a Team automatically converts them to a paid guest.\
 \
If no paid guest seats are available, an additional member seat will be added, increasing the number of paid guest seats.\
 \
This change incurs a prorated charge based on the billing cycle.

## Path parameters

- `team_id` number, required

## Request body

- object
  - `name` string, required
  - `handle` string
  - `members` integer[], required

## Response `200`

- object
  - `id` string, required
  - `team_id` string, required
  - `userid` integer, required
  - `name` string, required
  - `handle` string, required
  - `date_created` string, required
  - `initials` string, required
  - `members` object[], required
    - `id` integer, required
    - `username` string, required
    - `email` string, required
    - `color` string, required
    - `initials` string, required
    - `profilePicture` string, required
  - `avatar` Avatar, required — unresolved $ref

---

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