# List Slack user groups

Canonical URL: https://docs.fuse.init.inc/integrations/slack/actions/usergroups.list

List user groups in the Slack workspace.

Action ID: `usergroups.list`
Provider: Slack (`slack`)
Contract version: 1

## Risk and exposure

- Risk: Read
- Idempotency: Safe — Safe to retry without coordination; repeats do not create additional side effects.
- Availability: Default
- Exposure: REST, SDK, MCP
- MCP hints: readOnly=true, destructive=false, idempotent=true, openWorld=true

## Required scopes

- `usergroups:read`

## Input schema fields

- `include_users`
- `include_count`
- `include_disabled`

## Output schema fields

- `usergroups`
- `usergroups[]`
- `usergroups[].id`
- `usergroups[].name`
- `usergroups[].handle`
- `usergroups[].description`
- `usergroups[].user_count`

Provider overview: https://docs.fuse.init.inc/integrations/slack
Actions index: https://docs.fuse.init.inc/integrations/slack/actions
Exact canonical JSON contract: https://docs.fuse.init.inc/api/catalog/v1/providers/slack/actions/usergroups.list
Deployment-effective discovery: https://api.fuse.init.inc/v1/tenants/%7Btenant_id%7D/providers/slack/actions