Menu

Samenvatting van de ClickUp API

Met de ClickUp API bouw je integraties die werk, planning en samenwerking automatisch synchroon houden met je CRM, helpdesk of engineeringstack. Elk object in de ClickUp-hierarchie (workspace, space, folder, list, task) is atomair aanspreekbaar en uitbreidbaar via custom fields, tags en views.
  • Taken en lijsten: Volledige CRUD op taken, lijsten, mappen en ruimtes met filters, dependencies, checklists en bulk-time-in-status-queries.
  • Doelen en OKR's: Beheer goals en key results voor team-OKR's, gekoppeld aan taken en metrics.
  • Custom fields en tags: Lees en update custom-field-waarden per taak en beheer space-tags voor classificatie en filtering.
  • Time tracking: Start, stop en muteer time-entries via de moderne v2-API of de legacy-endpoints inclusief tags per entry.
  • Docs en chat: Maak via v3 docs en pages aan, beheer chatkanalen en stuur of update messages, replies en reacties.
  • Governance en events: Lees audit-logs op workspace-niveau, beheer privacy-ACL's en abonneer je op webhooks voor realtime events.
API Quick Facts REST
  • Authenticatie OAuth2, API Key, Bearer Token
  • Methods POST (52)GET (66)PUT (21)DELETE (29)PATCH (4)
  • Rate limits Niet gespecificeerd
  • Webhooks Beschikbaar
  • Sandbox Niet beschikbaar
  • Response format JSON
  • Versionering URL-based

Laatste ontwikkelingen bij de ClickUp API

ClickUp publiceerde in 2019 de eerste publieke v2-REST API onder /api/v2 met endpoints voor tasks, lists, folders en spaces. In 2020-2022 volgden goals, custom fields, time tracking, dependencies en webhooks. In 2023 kwamen views, audit-logs en custom roles erbij. Vanaf 2024 draait een nieuwe v3-API onder /api/v3/workspaces/{workspace_id}/ voor docs, chat-kanalen, audit-logs en attachments. Beide versies leven naast elkaar; v2 blijft backward-compatible en v3 wordt iteratief uitgebreid met nieuwe resource-types. Authenticatie verloopt via OAuth 2.0 of een persoonlijke API-token.

API versies

Chat API (v3) Major release
1 februari 2025

Volledige Chat-API onder v3 toegevoegd voor channels, messages, reacties en replies inclusief direct messages.

Audit logs (v3) Major release
1 september 2024

Workspace-level audit-log-endpoint en privacy-ACL-endpoint toegevoegd onder v3.

Docs API (v3) Major release
1 mei 2024

Publieke Docs- en Pages-endpoints onder v3 toegevoegd inclusief search en page-listing.

Views & Custom Roles Major release
1 maart 2023

Views-endpoints op workspace-, space-, folder- en list-niveau toegevoegd plus custom-roles-endpoint.

Time tracking 2.0
1 september 2021

Nieuwe time-entries-endpoints met tags, history en running-entry; legacy /time-endpoints blijven beschikbaar.

Webhooks & dependencies Major release
1 november 2020

Webhooks-endpoints en task-dependencies/links toegevoegd voor realtime sync en taakrelaties.

Publieke v2 API Major release
1 juni 2019

Eerste publieke REST API onder /api/v2 met tasks, lists, folders, spaces en teams.