clickup_update_user_group
Update a user group's name, handle, or membership by specifying group ID and changes to add or remove members.
Instructions
Rename a User Group and/or add/remove its members.
Calls PUT /group/{group_id} (ClickUp's endpoint slug is updateteam,
but group_id here addresses a User Group, never a Workspace —
do not pass a team_id in this field). Member changes use ClickUp's
{"add": [...], "rem": [...]} shape nested under members; name and
handle are replaced wholesale when provided.
When to Use:
To rename a group, change its @mention handle, or add/remove members without deleting and recreating the group.
When NOT to Use:
To create a brand-new group, use
clickup_create_user_group.To remove the group entirely, use
clickup_delete_user_group.
Returns: A confirmation string with the updated group's name, group_id, and resulting member count.
Examples: params = {"group_id": "4bfdfcec-6f4f-40a7-b0d6-22660d51870d", "name": "QA Team"} params = { "group_id": "4bfdfcec-6f4f-40a7-b0d6-22660d51870d", "add_member_ids": [123456], "remove_member_ids": [159753], }
Error Handling: 404 if group_id doesn't exist; 403 if the token lacks permission. 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 |