clickup-common-errors

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 <[e-mail]>
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

# Diagnose: verify your token works
curl -s -w "\nHTTP %{http_code}\n" \
  https://api.clickup.com/api/v2/user \
  -H