clickup

Work with tasks using the ClickUp API.

clickup publishes 12 APIs on the APIs.io network, including Tasks API, Spaces API, Lists API, and 9 more.

The clickup catalog on APIs.io includes 1 event-driven AsyncAPI specification, 1 JSON-LD context, and 2 Spectral governance rulesets.

clickup’s developer surface includes authentication, engineering blog, and 9 more developer resources.

🌐 Visit website 📡 Source on GitHub

46.4/100 developing ▬ flat Agent 54/100 agent ready Full breakdown ↓
scored 2026-07-21 · rubric v0.4

12 APIs 16 Features

API Rating

API Evangelist Rating How this is scored →
scored 2026-07-21 · rubric v0.4

Composite quality — 46.4/100 · developing

Contract Quality 19.5 / 25

Developer Ergonomics 2.6 / 20

Commercial Clarity 9.5 / 20

Operational Transparency 4.8 / 13

Governance 6.3 / 12

Discoverability 3.8 / 10

Agent readiness — 54/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 15 / 15

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 6 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/clickup: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs

ClickUp Tasks API

The ClickUp Tasks API allows developers to create, read, update, and delete tasks within ClickUp workspaces. Tasks are the core unit of work in ClickUp and can include custom fi...

ClickUp Spaces API

The ClickUp Spaces API provides endpoints for managing Spaces, which are the top-level organizational containers within a ClickUp Workspace. Spaces contain Folders and Lists tha...

ClickUp Lists API

The ClickUp Lists API enables developers to manage Lists, which are containers that hold tasks within a Space or Folder. Lists define the workflow statuses available to tasks an...

ClickUp Folders API

The ClickUp Folders API provides endpoints for managing Folders, which are optional organizational containers that sit between Spaces and Lists in the ClickUp hierarchy. Folders...

ClickUp Goals API

The ClickUp Goals API allows developers to create and manage goals within a Workspace. Goals can track progress toward objectives using targets based on numbers, currency, perce...

ClickUp Comments API

The ClickUp Comments API provides endpoints for creating and retrieving comments on tasks, views, and lists. Comments support rich text formatting, mentions, and attachments. De...

ClickUp Teams (Workspaces) API

The ClickUp Teams API provides access to Workspace-level information and membership. In the ClickUp API, Teams correspond to Workspaces, which are the top-level organizational u...

ClickUp Webhooks API

The ClickUp Webhooks API enables developers to subscribe to real-time events within a Workspace. When subscribed events occur, ClickUp sends HTTP POST requests to a specified en...

ClickUp Custom Fields API

The ClickUp Custom Fields API allows developers to retrieve available custom fields for a list and set or update custom field values on tasks. Custom fields extend the default t...

ClickUp Time Tracking API

The ClickUp Time Tracking API provides endpoints for recording and retrieving time entries associated with tasks. Developers can create manual time entries, start and stop timer...

ClickUp Views API

The ClickUp Views API enables developers to create and manage views at the team, space, folder, and list levels. Views define how tasks are displayed and filtered, supporting fo...

ClickUp OAuth API

The ClickUp OAuth API implements the authorization code grant type, allowing third-party applications to authenticate users and access their ClickUp Workspaces. Workspace owners...

Collections

ClickUp Comments API

OPEN

ClickUp Custom Fields API

OPEN

ClickUp Folders API

OPEN

ClickUp Goals API

OPEN

ClickUp Lists API

OPEN

ClickUp OAuth API

OPEN

ClickUp Spaces API

OPEN

ClickUp Tasks API

OPEN

ClickUp Teams (Workspaces) API

OPEN

ClickUp Time Tracking API

OPEN

ClickUp Views API

OPEN

ClickUp Webhooks API

OPEN

GraphQL

ClickUp GraphQL

ClickUp does not offer a native public GraphQL API. The platform exposes its functionality exclusively through a REST API (v2) available at `https://api.clickup.com/api/v2`. The...

GRAPHQL

Pricing Plans

Clickup Plans Pricing

4 plans

PLANS

Scroll for all 12

Business at $12/user/mo with dashboards, automations (5K/mo), Google SSO

Enterprise: SAML/SCIM, MSA/HIPAA, 250K automations/mo, data residency

REST API v2: 100/min Free, 1000/min Unlimited/Business, 10K/min Enterprise

Webhooks for task, list, space, doc events

OAuth 2.0 and personal API tokens

Custom Fields API

Goals, Portfolios, Time Tracking APIs

Docs, Whiteboards, Forms

ClickUp Chat (Business+)

ClickUp AI for content and automation (per-user add-on)

Sprint management with story points

Mind maps and Gantt charts

1,000+ integrations

Custom branding and audit log on Enterprise

Documentation 2

Reference material describing how the API behaves

JSONSchema

JSONSchema

JSONSchema

JSONSchema

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

LlmsText

LlmsText

Design & Contract 1

Pagination, idempotency, versioning, errors, and events

JSONLD

JSONLD

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrganization

GitHubOrganization

Access & Security 3

Authentication, authorization, and security posture

TrustCenter

TrustCenter

DomainSecurity

DomainSecurity

Authentication

Authentication

Company 2

The organization behind the API

LinkedIn

Blog

Blog

Source (apis.yml)

opencollection: 1.0.0
info:
  name: ClickUp Webhooks API
  version: '2.0'
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: Webhooks
    type: folder
  items:
  - info:
      name: Get webhooks
      type: http
    http:
      method: GET
      url: https://api.clickup.com/api/v2/team/:team_id/webhook
      params:
      - name: team_id
        value: ''
        type: path
        description: The unique identifier of the Workspace (team).
    docs: Retrieves all webhook subscriptions for a Workspace. Returns webhook details including the endpoint URL, subscribed
      events, status, and health information.
  - info:
      name: Create a webhook
      type: http
    http:
      method: POST
      url: https://api.clickup.com/api/v2/team/:team_id/webhook
      params:
      - name: team_id
        value: ''
        type: path
        description: The unique identifier of the Workspace (team).
      body:
        type: json
        data: '{}'
    docs: Creates a new webhook subscription for a Workspace. The webhook can be configured to listen for specific events
      and send notifications to a specified endpoint URL. A shared secret is returned for signature verification of incoming
      webhook payloads.
  - info:
      name: Update a webhook
      type: http
    http:
      method: PUT
      url: https://api.clickup.com/api/v2/webhook/:webhook_id
      params:
      - name: webhook_id
        value: ''
        type: path
        description: The unique identifier of the webhook.
      body:
        type: json
        data: '{}'
    docs: Updates an existing webhook subscription. The endpoint URL, subscribed events, and status can be modified.
  - info:
      name: Delete a webhook
      type: http
    http:
      method: DELETE
      url: https://api.clickup.com/api/v2/webhook/:webhook_id
      params:
      - name: webhook_id
        value: ''
        type: path
        description: The unique identifier of the webhook.
    docs: Permanently deletes a webhook subscription. ClickUp will stop sending events to the endpoint URL immediately.
bundled: true