clickup

Work with tasks using the ClickUp API.

12 APIs 16 Features

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

Rate Limits

Clickup Rate Limits

4 limits

RATE LIMITS

FinOps

Clickup Finops

FINOPS

Features

Free plan: 60MB storage, unlimited tasks/members

Unlimited at $7/user/mo annual with unlimited everything

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

Sources

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