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