ClickUp API

Documents & Productivity / OAuth Advanced HTTPS

Varies by plan (check documentation)

68 Score

Grade C

Visit Official Site Compare Alternatives

Overview

The ClickUp API provides access to tasks, spaces, folders, lists, goals, and time-tracking data within your ClickUp workspace. It supports building integrations, automating task management, and syncing project data with other tools. OAuth is required for apps serving multiple users, but personal tokens work well for single-workspace automation.

💡

Beginner Tip

Start with a personal API token from your ClickUp profile settings to avoid the OAuth flow during initial testing. Retrieve your team ID first with GET /team, as most other endpoints require it.

Available Data

ClickUp data via REST API

JSON-formatted response data

Requires OAuth authentication

Example Response

JSON Response

{
  "route": "Line 1",
  "origin": "Station A",
  "destination": "Station B",
  "departure": "08:30",
  "arrival": "09:15",
  "status": "On Time",
  "delays_min": 0
}

Field Reference

teams List of workspace (team) objects accessible with your token.

teams[].id Unique identifier for the workspace, required in most endpoint paths.

teams[].name Display name of the workspace.

teams[].members Array of member objects with user details for the workspace.

tasks Array of task objects returned when querying tasks in a list or space.

Implementation Example

// ⚠️ Note: This URL may be a documentation page. Check official docs for actual API endpoint.
const url = "https://clickup.com/api";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "Authorization": "Bearer YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);