clickup_get_chat_channels
List chat channels in a ClickUp workspace. Filter by channel type, follower status, or recent activity to find specific channels.
Instructions
List the Chat channels in a Workspace, with descriptor filters.
Returns Channels, DMs, and Group DMs the authorized user can see. Narrow the
result with channel_types, is_follower, include_closed, or
with_message_since. Results are cursor-paginated.
When to Use:
To find a channel's id before reading it (
clickup_get_chat_channel), posting to it, or listing its members.To enumerate only DMs (
channel_types=["DM","GROUP_DM"]) or only followed channels (is_follower=true).
When NOT to Use:
To read messages in a channel — that lives in
clickup_get_chat_messages(chat_messages module).
Returns:
A list of channels (name, id, type, visibility). When more results exist the
response includes a next_cursor; pass it back as cursor to page forward.
Pagination:
Cursor-based and asymmetric. Loop: call once, read next_cursor from the
output, then call again with cursor=<next_cursor> until it is empty.
Examples:
params = {"channel_types": ["CHANNEL"], "limit": 100}
params = {"is_follower": true, "cursor": "eyJ..."}
Error Handling:
401 → bad token; 404 → unknown Workspace id. Errors return an Error ... string.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |