| name | clickup-common-errors |
| description | Diagnose and fix ClickUp API v2 errors by HTTP status and error code.
Use when encountering ClickUp API errors, debugging failed requests,
or troubleshooting OAUTH_* error codes, 401s, 429s, and 500s.
Trigger: "clickup error", "fix clickup", "clickup not working",
"clickup 401", "clickup 429", "OAUTH error", "debug clickup API".
|
| allowed-tools | Read, Grep, Bash(curl:*) |
| version | 1.6.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","productivity","clickup"] |
| compatibility | Designed for Claude Code |
ClickUp Common Errors
Overview
Reference for ClickUp API v2 errors. All errors return JSON with err (message) and optionally ECODE (error code).
Error Response Format
{
"err": "Space not found",
"ECODE": "ITEM_015"
}
HTTP Status Errors
400 Bad Request
| Situation | Response | Fix |
|---|
| Missing required field | {"err": "Task name required"} | Include name in request body |
| Invalid field value | {"err": "Invalid priority"} | Priority must be 1-4 or null |
| Malformed JSON | {"err": "Unexpected token"} | Validate JSON before sending |
| Invalid custom field value | {"err": "Invalid value for field"} | Match value to field type |
401 Unauthorized — OAuth Errors
| ECODE | Cause | Solution |
|---|
| OAUTH_017 | Token malformed or missing | Include Authorization: <token> header |
| OAUTH_023 | Workspace not authorized for token | User must re-authorize workspace in OAuth flow |
| OAUTH_026 | Token revoked by user | Generate new personal token or re-authenticate |
| OAUTH_027 | Workspace not authorized | Re-authorize via OAuth, ensuring workspace scope |
| OAUTH_029-045 | Various workspace auth failures | Re-run OAuth flow for the specific workspace |
curl -s -w "\nHTTP %{http_code}\n" \
https://api.clickup.com/api/v2/user \
-H
