ClickUp

Overview

The ClickUp API v2 manages tasks, lists, folders, docs, and teams in the ClickUp workspace. Auth is an API token (personal token or OAuth) — a missing token returns HTTP 400 "Authorization header required" (verified).

Quick Start

Teams (replace YOUR_TOKEN):

curl "https://api.clickup.com/api/v2/team" \
  -H "Authorization: YOUR_TOKEN"

{ "teams": [ { "id": "123", "name": "My Team", "members": [] } ] }

Tasks in a list:

curl "https://api.clickup.com/api/v2/list/LIST_ID/task?include_closed=true" \
  -H "Authorization: YOUR_TOKEN"

Create a task:

curl -X POST "https://api.clickup.com/api/v2/list/LIST_ID/task" \
  -H "Authorization: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "New task"}'

Authentication

• Personal token: ClickUp → Settings → Apps → API Token.
• Or OAuth 2.0 for third-party apps.
• Send as Authorization: YOUR_TOKEN (missing → 400 “Authorization header required”, verified).

Rate Limits & Notes

• Rate limits vary by plan (free: modest; paid: higher) — check the docs.
• The v2 API covers tasks, lists, folders, spaces, docs, time tracking.
• Team IDs are used to scope API access.

FAQ

Is ClickUp API free? API access is included in plans; free tier has limits.

How do I get a token? Settings → Apps → API Token.

Why 400 without auth? ClickUp returns 400 “Authorization header required” (verified) — send the Authorization header.