ClickUp

ClickUp workspace API for reading and writing tasks, lists, folders, spaces, comments, time entries, docs, and chat. Best for syncing task state into or out of ClickUp, automating status transitions, or pulling pipeline data into reports. Covers both v2 (team/space/list/task hierarchy, time tracking, webhooks) and v3 (chat, docs, audit logs). 16 example endpoints available through Lava’s AI Gateway. See the ClickUp API docs for full documentation.

This provider requires your own credentials — connect your API key or OAuth account before use.

This is a catch-all provider — any valid URL under https://api.clickup.com is supported. Any ClickUp API endpoint. v2 paths start with /api/v2 (most of the product — workspaces/teams, spaces, folders, lists, tasks, comments, time tracking, webhooks). v3 paths start with /api/v3 (chat, docs, audit logs, attachments). Construct URL as https://api.clickup.com/{path}. See https://developer.clickup.com/reference for full reference. The endpoints below are curated examples.

Endpoints

List Workspaces (called “teams” in the v2 API) the authorized user can access. Use first to discover workspace IDs for downstream calls.

GET https://api.clickup.com/api/v2/team — Free

SDK
cURL

const data = await lava.gateway('https://api.clickup.com/api/v2/team', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.clickup.com%2Fapi%2Fv2%2Fteam" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Get the authorized user.

GET https://api.clickup.com/api/v2/user — Free

SDK
cURL

const data = await lava.gateway('https://api.clickup.com/api/v2/user', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.clickup.com%2Fapi%2Fv2%2Fuser" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List spaces under a Workspace (team_id).

GET https://api.clickup.com/api/v2/team/{team_id}/space — Free

SDK
cURL

const data = await lava.gateway('https://api.clickup.com/api/v2/team/{team_id}/space', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.clickup.com%2Fapi%2Fv2%2Fteam%2F%7Bteam_id%7D%2Fspace" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List folders under a space.

GET https://api.clickup.com/api/v2/space/{space_id}/folder — Free

SDK
cURL

const data = await lava.gateway('https://api.clickup.com/api/v2/space/{space_id}/folder', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.clickup.com%2Fapi%2Fv2%2Fspace%2F%7Bspace_id%7D%2Ffolder" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List lists under a folder.

GET https://api.clickup.com/api/v2/folder/{folder_id}/list — Free

SDK
cURL

const data = await lava.gateway('https://api.clickup.com/api/v2/folder/{folder_id}/list', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.clickup.com%2Fapi%2Fv2%2Ffolder%2F%7Bfolder_id%7D%2Flist" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List tasks in a list. Supports filters: page, archived, include_closed, order_by, assignees, tags, due_date_gt, etc.

GET https://api.clickup.com/api/v2/list/{list_id}/task?archived=false&include_closed=false — Free

SDK
cURL

const data = await lava.gateway('https://api.clickup.com/api/v2/list/{list_id}/task?archived=false&include_closed=false', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.clickup.com%2Fapi%2Fv2%2Flist%2F%7Blist_id%7D%2Ftask%3Farchived%3Dfalse%26include_closed%3Dfalse" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Create a task in a list.

POST https://api.clickup.com/api/v2/list/{list_id}/task — Free

SDK
cURL

const data = await lava.gateway('https://api.clickup.com/api/v2/list/{list_id}/task', {
  body: {
"name": "New task from Lava",
"description": "Created via the gateway",
"status": "to do"
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.clickup.com%2Fapi%2Fv2%2Flist%2F%7Blist_id%7D%2Ftask" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"New task from Lava","description":"Created via the gateway","status":"to do"}'

Retrieve a single task by ID. Supports custom_task_ids and team_id query params.

GET https://api.clickup.com/api/v2/task/{task_id} — Free

SDK
cURL

const data = await lava.gateway('https://api.clickup.com/api/v2/task/{task_id}', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.clickup.com%2Fapi%2Fv2%2Ftask%2F%7Btask_id%7D" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Update a task. Only fields in the body are modified — use status, name, description, priority, assignees_add, assignees_rem, etc.

PUT https://api.clickup.com/api/v2/task/{task_id} — Free

SDK
cURL

const data = await lava.gateway('https://api.clickup.com/api/v2/task/{task_id}', { method: 'PUT', body: {"status":"in progress"} });

curl -X PUT "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.clickup.com%2Fapi%2Fv2%2Ftask%2F%7Btask_id%7D" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"in progress"}'

Delete a task.

DELETE https://api.clickup.com/api/v2/task/{task_id} — Free

SDK
cURL

const data = await lava.gateway('https://api.clickup.com/api/v2/task/{task_id}', { method: 'DELETE' });

curl -X DELETE "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.clickup.com%2Fapi%2Fv2%2Ftask%2F%7Btask_id%7D" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json"

Get filtered tasks across a whole Workspace. Supports page, assignees, statuses, tags, date filters, space_ids, project_ids, list_ids.

GET https://api.clickup.com/api/v2/team/{team_id}/task?include_closed=false — Free

SDK
cURL

const data = await lava.gateway('https://api.clickup.com/api/v2/team/{team_id}/task?include_closed=false', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.clickup.com%2Fapi%2Fv2%2Fteam%2F%7Bteam_id%7D%2Ftask%3Finclude_closed%3Dfalse" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Add a comment to a task.

POST https://api.clickup.com/api/v2/task/{task_id}/comment — Free

SDK
cURL

const data = await lava.gateway('https://api.clickup.com/api/v2/task/{task_id}/comment', {
  body: {
"comment_text": "Posted via Lava gateway.",
"notify_all": false
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.clickup.com%2Fapi%2Fv2%2Ftask%2F%7Btask_id%7D%2Fcomment" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"comment_text":"Posted via Lava gateway.","notify_all":false}'

Get time entries within a date range for a Workspace. Supports start_date, end_date, assignee, include_task_tags.

GET https://api.clickup.com/api/v2/team/{team_id}/time_entries — Free

SDK
cURL

const data = await lava.gateway('https://api.clickup.com/api/v2/team/{team_id}/time_entries', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.clickup.com%2Fapi%2Fv2%2Fteam%2F%7Bteam_id%7D%2Ftime_entries" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Create a time entry for a Workspace.

POST https://api.clickup.com/api/v2/team/{team_id}/time_entries — Free

SDK
cURL

const data = await lava.gateway('https://api.clickup.com/api/v2/team/{team_id}/time_entries', {
  body: {
"start": 1700000000000,
"duration": 3600000,
"description": "Working on task",
"tid": "{task_id}"
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.clickup.com%2Fapi%2Fv2%2Fteam%2F%7Bteam_id%7D%2Ftime_entries" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start":1700000000000,"duration":3600000,"description":"Working on task","tid":"{task_id}"}'

Create a webhook subscription for a Workspace.

POST https://api.clickup.com/api/v2/team/{team_id}/webhook — Free

SDK
cURL

const data = await lava.gateway('https://api.clickup.com/api/v2/team/{team_id}/webhook', {
  body: {
"endpoint": "https://example.com/clickup-webhook",
"events": [
  "taskCreated",
  "taskUpdated"
]
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.clickup.com%2Fapi%2Fv2%2Fteam%2F%7Bteam_id%7D%2Fwebhook" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"endpoint":"https://example.com/clickup-webhook","events":["taskCreated","taskUpdated"]}'

Update a Chat channel (v3) — name, description, topic, visibility.

PATCH https://api.clickup.com/api/v3/workspaces/{workspace_id}/chat/channels/{channel_id} — Free

SDK
cURL

const data = await lava.gateway('https://api.clickup.com/api/v3/workspaces/{workspace_id}/chat/channels/{channel_id}', { method: 'PATCH', body: {"name":"Renamed channel"} });

curl -X PATCH "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.clickup.com%2Fapi%2Fv3%2Fworkspaces%2F%7Bworkspace_id%7D%2Fchat%2Fchannels%2F%7Bchannel_id%7D" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Renamed channel"}'

Get Started

AI Gateway

AI Spend

Monetize

Integration

SDK

Cookbook

Comparisons

Endpoints

List Workspaces (called “teams” in the v2 API) the authorized user can access. Use first to discover workspace IDs for downstream calls.

Get the authorized user.

List spaces under a Workspace (team_id).

List folders under a space.

List lists under a folder.

List tasks in a list. Supports filters: page, archived, include_closed, order_by, assignees, tags, due_date_gt, etc.

Create a task in a list.

Retrieve a single task by ID. Supports custom_task_ids and team_id query params.

Update a task. Only fields in the body are modified — use status, name, description, priority, assignees_add, assignees_rem, etc.

Delete a task.

Get filtered tasks across a whole Workspace. Supports page, assignees, statuses, tags, date filters, space_ids, project_ids, list_ids.

Add a comment to a task.

Get time entries within a date range for a Workspace. Supports start_date, end_date, assignee, include_task_tags.

Create a time entry for a Workspace.

Create a webhook subscription for a Workspace.

Update a Chat channel (v3) — name, description, topic, visibility.

Next Steps

All Providers

Forward Proxy

​Endpoints

​List Workspaces (called “teams” in the v2 API) the authorized user can access. Use first to discover workspace IDs for downstream calls.

​Get the authorized user.

​List spaces under a Workspace (team_id).

​List folders under a space.

​List lists under a folder.

​List tasks in a list. Supports filters: page, archived, include_closed, order_by, assignees, tags, due_date_gt, etc.

​Create a task in a list.

​Retrieve a single task by ID. Supports custom_task_ids and team_id query params.

​Update a task. Only fields in the body are modified — use status, name, description, priority, assignees_add, assignees_rem, etc.

​Delete a task.

​Get filtered tasks across a whole Workspace. Supports page, assignees, statuses, tags, date filters, space_ids, project_ids, list_ids.

​Add a comment to a task.

​Get time entries within a date range for a Workspace. Supports start_date, end_date, assignee, include_task_tags.

​Create a time entry for a Workspace.

​Create a webhook subscription for a Workspace.

​Update a Chat channel (v3) — name, description, topic, visibility.

​Next Steps

All Providers

Forward Proxy

Endpoints

List Workspaces (called “teams” in the v2 API) the authorized user can access. Use first to discover workspace IDs for downstream calls.

Get the authorized user.

List spaces under a Workspace (team_id).

List folders under a space.

List lists under a folder.

List tasks in a list. Supports filters: page, archived, include_closed, order_by, assignees, tags, due_date_gt, etc.

Create a task in a list.

Retrieve a single task by ID. Supports custom_task_ids and team_id query params.

Update a task. Only fields in the body are modified — use status, name, description, priority, assignees_add, assignees_rem, etc.

Delete a task.

Get filtered tasks across a whole Workspace. Supports page, assignees, statuses, tags, date filters, space_ids, project_ids, list_ids.

Add a comment to a task.

Get time entries within a date range for a Workspace. Supports start_date, end_date, assignee, include_task_tags.

Create a time entry for a Workspace.

Create a webhook subscription for a Workspace.

Update a Chat channel (v3) — name, description, topic, visibility.

Next Steps