Official ClickUp Sources
Verified on 2026-09-10. Re-check these sources before relying on plan, endpoint, token-lifetime, or preview-feature behavior.
Platform contracts
- Get started
- Authentication
- API v2 and v3 terminology
- OpenAPI specifications
- API availability by plan
- Common errors
- Frequently asked questions
- ClickUp status
Work and data contracts
Event and enterprise contracts
- Webhooks
- Webhook signature
- Webhook health
- Get Custom Roles
- Workspace audit logs
- Object and location ACLs
- Official API v2 demo
Review notes
- Most work-management endpoints remain under
/api/v2; selected newer surfaces use/api/v3. Do not describe v3 as a complete replacement. - In v2,
team_idmeans Workspace ID. A group is a user group, not a Workspace. - Use the official OpenAPI documents as endpoint schemas and validate plan availability against the authorized Workspace.
- Treat ClickUp response bodies as potentially sensitive work content. Evidence should retain redacted identifiers, counts, hashes, status, and timing—not task text, comments, attachments, tokens, or webhook secrets.