clickup_create_user_group
Create a user group in a workspace to organize members into reusable named sets for mentions and task assignments.
Instructions
Create a User Group (ClickUp's endpoint calls this a "Team") in a Workspace.
Calls POST /team/{team_id}/group. Despite the path living under
/team/..., team_id here is the Workspace id — the resource
created is a User Group, addressed afterwards by its own group_id
(a UUID, e.g. "4bfdfcec-6f4f-40a7-b0d6-22660d51870d"). Never confuse
the two: team_id = Workspace, group_id = User Group.
When to Use:
To create a reusable named set of members (e.g. "QA", "Product") that can be @mentioned or assigned as a unit across Spaces/Folders/Lists.
When NOT to Use:
To add/remove members on an existing group, use
clickup_update_user_groupinstead of deleting and recreating it.
Returns: A confirmation string with the new group's group_id, name, and member count.
Examples: params = {"team_id": "123456", "name": "Product Managers", "members": [183, 812]}
Error Handling:
403 if the plan doesn't support User Groups or the token lacks
permission; 400 if members contains invalid user ids. Note: adding a
view-only guest to a group can convert them to a paid guest (billing
impact) — ClickUp's own docs warn about this.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |