clickup_get_user_groups
List all User Groups in a ClickUp Workspace. Use this to retrieve group IDs for updating or deleting groups, or to audit group membership.
Instructions
List the User Groups in a Workspace (ClickUp's endpoint slug: "getteams1").
Calls GET /group?team_id=.... NB the naming trap: the underlying
ClickUp endpoint is historically named "Teams", but the resource
returned is a User Group (group_id), not the Workspace itself
(team_id) — pass the Workspace id via team_id and optionally narrow
to specific groups via group_ids.
When to Use:
To look up a group's
group_idbefore callingclickup_update_user_group/clickup_delete_user_group.To audit which User Groups exist in a Workspace and who is in them.
When NOT to Use:
To list plain (ungrouped) Workspace members, use a Workspace-members tool in another module — this tool only returns User Groups.
Returns: A markdown (or JSON) list of groups with group_id, name, handle, and member count.
Examples: params = {"team_id": "123456"} params = {"team_id": "123456", "group_ids": ["4bfdfcec-6f4f-40a7-b0d6-22660d51870d"]}
Error Handling: 400/404 if team_id is missing or invalid.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |