โ† ClaudeAtlas

clickup-apilisted

ClickUp v3 API conventions, channel/DM creation rules, thread reply endpoints, and the company-wide ๐Ÿงž emoji prefix requirement for any Claude-authored ClickUp message. Use when sending ClickUp messages, creating channels, replying to threads, or scripting against the ClickUp API.
search-atlas-group/amm-founding-circle ยท โ˜… 0 ยท API & Backend ยท score 75
Install: claude install-skill search-atlas-group/amm-founding-circle
# clickup-api ClickUp v3 quirks the team has been bitten by. Read before sending any message, creating any channel, or calling any ClickUp endpoint. ## Hard rules (NEVER violate) ### Never create public channels **Forbidden:** `POST /chat/channels` โ€” creates a public channel visible to the entire 50+ person workspace. This has caused real noise/cleanup incidents. **Required pattern:** `POST /chat/channels/direct_message` with `user_ids` โ€” creates a private DM (1 user) or group DM (2+ users). All messaging to teammates routes through DMs, never new public channels. ### Always prefix team-facing messages with ๐Ÿงž Any ClickUp message sent to teammates via Claude โ€” DM, group DM, thread reply, or channel post โ€” MUST start with the ๐Ÿงž emoji. Lets recipients identify Claude-authored messages at a glance. Applies to all scripts, MCP tools, and direct API calls. No exceptions. ## Endpoint reference ### DM creation - `POST /chat/channels/direct_message` body: `{"user_ids": [<numeric>, ...]}` - 1 user_id โ†’ private 1:1 DM - 2+ user_ids โ†’ group DM - Returns channel ID โ€” then `POST /chat/channels/{id}/messages` to send. ### Thread replies - Reply to a message: `POST /messages/{message_id}/replies` - **NOT** the channel endpoint. A common mistake is posting back to the channel as a new top-level message instead of as a reply on the thread. ### Channel listing - `GET /chat/channels` โ€” paginated. Use the `cursor` from `next_cursor` field for the next page. `total_count` field returns