clickup_create_direct_message
Create a direct-message Chat channel with up to 15 users, supporting 1:1, group, or self DMs. Returns existing channel if same participant set already exists.
Instructions
Create (or return) a direct-message Chat channel with up to 15 users.
One recipient id makes a 1:1 DM; two or more make a Group DM. Omit user_ids
(or pass an empty list) to create a Self DM. ClickUp returns the existing DM
channel if one already exists for the same participant set.
When to Use:
To message one or a few users directly rather than in a shared channel.
When NOT to Use:
For a named or location-bound channel — use
clickup_create_chat_channelorclickup_create_location_chat_channel.
Returns: A confirmation with the DM channel's id and participant count.
Examples:
params = {"user_ids": ["123"]}
params = {"user_ids": ["123", "456", "789"]}
params = {} # Self DM
Error Handling:
400 → more than 15 users / bad id; 401 → bad token. Errors return an Error ... string.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |