clickup_create_chat_channel
Create a workspace chat channel by name. Returns existing channel if name matches. Specify visibility, users, or topic as needed.
Instructions
Create a Workspace-level Chat channel by name.
If a Channel with the given name already exists, ClickUp returns that existing Channel instead of creating a duplicate.
When to Use:
To open a general, non-location-bound channel (e.g. "#announcements").
When NOT to Use:
To attach a channel to a Space/Folder/List — use
clickup_create_location_chat_channel.To start a direct message — use
clickup_create_direct_message.
Returns: A confirmation with the channel's name, id, and visibility.
Examples:
params = {"name": "announcements", "visibility": "PUBLIC"}
params = {"name": "team-x", "user_ids": ["123", "456"], "topic": "Team X"}
Error Handling:
400 → bad payload; 401 → bad token. Errors return an Error ... string.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |