> For the complete documentation index, see [llms.txt](https://docs.planetcrust.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.planetcrust.com/human-connections/clickup/clickup.md).
# ClickUp
Try @Human Buy @Human Subscription Join @Human Community
Put ClickUp to Work with @Human Automations and @Human Agents
The ClickUp Connection documents all Triggers, Actions and Query Operations available for creating automations via the ClickUp API.
{% embed url="" %}
#### What can you do with the ClickUp Connection?
* Connect to the ClickUp API in a few clicks
* Use the related ClickUp Operations (see below) in @Human Automations or @Human Agents
### Related Operations
#### Trigger Operations
**Task Comment Posted**
Triggers on: comments/taskCommentPosted
Triggered when a new comment is posted on a task.
**Task Comment Updated**
Triggers on: comments/taskCommentUpdated
Triggered when an existing comment on a task is updated.
**Folder Created**
Triggers on: folders/folderCreated
Triggered when a new folder is created in a space.
**Folder Updated**
Triggers on: folders/folderUpdated
Triggered when a folder's details or settings are updated.
**Folder Deleted**
Triggers on: folders/folderDeleted
Triggered when a folder is deleted.
**Goal Created**
Triggers on: goals/goalCreated
Triggered when a new goal is created in a workspace.
**Goal Updated**
Triggers on: goals/goalUpdated
Triggered when a goal's details or progress are updated.
**Goal Deleted**
Triggers on: goals/goalDeleted
Triggered when a goal is deleted.
**Key Result Created**
Triggers on: goals/keyResultCreated
Triggered when a new key result is added to a goal.
**Key Result Updated**
Triggers on: goals/keyResultUpdated
Triggered when a key result's details or progress are updated.
**Key Result Deleted**
Triggers on: goals/keyResultDeleted
Triggered when a key result is removed from a goal.
**List Created**
Triggers on: lists/listCreated
Triggered when a new list is created.
**List Updated**
Triggers on: lists/listUpdated
Triggered when a list's details or settings are updated.
**List Deleted**
Triggers on: lists/listDeleted
Triggered when a list is deleted.
**Space Created**
Triggers on: spaces/spaceCreated
Triggered when a new space is created in a workspace.
**Space Updated**
Triggers on: spaces/spaceUpdated
Triggered when a space's details or settings are updated.
**Space Deleted**
Triggers on: spaces/spaceDeleted
Triggered when a space is deleted.
**Task Created**
Triggers on: tasks/taskCreated
Triggered when a new task is created.
**Task Updated**
Triggers on: tasks/taskUpdated
Triggered when a task's details are updated.
**Task Deleted**
Triggers on: tasks/taskDeleted
Triggered when a task is deleted.
**Task Priority Updated**
Triggers on: tasks/taskPriorityUpdated
Triggered when a task's priority level is changed.
**Task Status Updated**
Triggers on: tasks/taskStatusUpdated
Triggered when a task's status is changed.
**Task Assignee Updated**
Triggers on: tasks/taskAssigneeUpdated
Triggered when a task's assignees are added or removed.
**Task Due Date Updated**
Triggers on: tasks/taskDueDateUpdated
Triggered when a task's due date is changed.
**Task Tag Updated**
Triggers on: tasks/taskTagUpdated
Triggered when tags are added to or removed from a task.
**Task Moved**
Triggers on: tasks/taskMoved
Triggered when a task is moved to a different list.
**Task Time Estimate Updated**
Triggers on: tasks/taskTimeEstimateUpdated
Triggered when a task's time estimate is changed.
**Task Time Tracked Updated**
Triggers on: tasks/taskTimeTrackedUpdated
Triggered when time is tracked or updated on a task.
#### Action Operations
[Action: Archive or Delete Task](/human-connections/clickup/clickup/action-create-a-project.md)
[Action: Send Direct Message](/human-connections/clickup/clickup/action-send-direct-message.md)
[Action: Create new Document](/human-connections/clickup/clickup/action-create-new-document.md)
[Action: Create Space](/human-connections/clickup/clickup/action-create-space.md)
#### Query Operations
Example link
### Related Automations
Example link
### Obtaining Access Credentials
To obtain a **Personal Access Token (PAT)** for **ClickUp**, follow these steps:
#### **Steps:**
1. **Log in** to your ClickUp account (ensure you have **admin permissions** if required).
2. Navigate to **Profile Settings**:
* Click your **profile avatar** (top-right) → **"My Settings"**.
3. Go to **Apps** → **"Generate"** under **Personal Token**.
4. Enter a **Token Name** (e.g., "System Integration").
5. Select the **scopes (permissions)** needed (e.g., full access or granular permissions).
6. Click **"Generate Token"**.
7. **Copy the token** (it will only be shown once).
#### **Required Account:**
* A **ClickUp user account** (free or paid, depending on API access needs).
### Configuring Webhooks
1. **Log in** to your ClickUp account.
2. Select the **Space, Folder, or List** where you want to implement the webhook.
3. Click the **Automate** button (lightning bolt icon) in the upper-right corner.
4. Select **Add Automation**.
5. Choose a **Trigger** (e.g., "Task created", "Status changed", or "Comment posted").
6. Select **Call webhook** as the **Action**.
7. Enter the **Webhook URL** provided by your integration.
8. (Optional) Add any desired **Headers** or **URL Parameters**.
9. Click **Create** to save and activate the webhook.
### Code (Apache v2.0): Service Connectivity and Metadata
```
{
"handle": "clickup",
"status": "active",
"meta": {
"short": "ClickUp",
"description": "Connect to ClickUp to manage tasks, projects, and workflows.",
"icon": "clickup",
"tags": ["project-management", "task-management", "productivity"]
},
"service": {
"baseURL": {
"value": "https://api.clickup.com/api/v2"
},
"protocol": "https",
"contentType": "application/json",
"headers": {
"Content-Type": {
"value": "application/json"
}
},
"auth": {
"method": "api_token",
"params": {
"apiToken": {
"token": {
"value": "{{apiToken}}",
"placeholders": [
{
"name": "apiToken",
"type": "String",
"description": "ClickUp API token",
"required": true
}
]
},
"headerName": {
"value": "Authorization"
}
}
}
}
}
}
```
### Code (Apache v2.0): List of External Resources and Internal Mapping
\[ { "handle": "workspaces", "meta": { "short": "Workspaces", "description": "Manage workspaces in ClickUp." }, "endpoint": { "value": "/team" }, "fields": \[ { "name": "id", "type": "String", "selector": \[ "id" ], "meta": { "description": "Unique identifier." } }, { "name": "name", "type": "String", "selector": \[ "name" ], "meta": { "description": "Name of the resource." } }, { "name": "date\_created", "type": "String", "selector": \[ "date\_created", "date" ], "meta": { "description": "Creation timestamp." } } ], "operations": { "list": { "method": "GET", "path": { "value": "/{{team\_id}}/plan" } } }, "webhooks": \[] }, { "handle": "checklists", "meta": { "short": "Task Checklists", "description": "Manage task checklists in ClickUp." }, "endpoint": { "value": "/task/{{task\_id}}/checklist" }, "fields": \[ { "name": "id", "type": "String", "selector": \[ "id" ], "meta": { "description": "Unique identifier." } }, { "name": "name", "type": "String", "selector": \[ "name" ], "meta": { "description": "Name of the resource." } }, { "name": "date\_created", "type": "String", "selector": \[ "date\_created", "date" ], "meta": { "description": "Creation timestamp." } } ], "operations": { "post": { "method": "POST", "path": { "value": "/checklist/{{checklist\_id}}/checklist\_item" } }, "put": { "method": "PUT", "path": { "value": "/checklist/{{checklist\_id}}/checklist\_item/{{checklist\_item\_id}}" } }, "delete": { "method": "DELETE", "path": { "value": "/checklist/{{checklist\_id}}/checklist\_item/{{checklist\_item\_id}}" } } }, "webhooks": \[] }, { "handle": "comments", "meta": { "short": "Comments", "description": "Manage comments in ClickUp." }, "endpoint": { "value": "/task/{{task\_id}}/comment" }, "fields": \[ { "name": "id", "type": "String", "selector": \[ "id" ], "meta": { "description": "Unique identifier." } }, { "name": "name", "type": "String", "selector": \[ "name" ], "meta": { "description": "Name of the resource." } }, { "name": "date\_created", "type": "String", "selector": \[ "date\_created", "date" ], "meta": { "description": "Creation timestamp." } } ], "operations": { "list": { "method": "GET", "path": { "value": "/comment/{{comment\_id}}/reply" } }, "post": { "method": "POST", "path": { "value": "/comment/{{comment\_id}}/reply" } }, "put": { "method": "PUT", "path": { "value": "/comment/{{comment\_id}}" } }, "delete": { "method": "DELETE", "path": { "value": "/comment/{{comment\_id}}" } } }, "webhooks": \[ { "event": "taskCommentPosted", "path": "/webhooks/clickup/taskCommentPosted", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "task\_id", "type": "String", "selector": \["task\_id"], "meta": { "description": "ID of the task the comment was posted on." } }, { "name": "comment\_id", "type": "String", "selector": \["history\_items", "0", "comment", "id"], "meta": { "description": "ID of the new comment." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who posted the comment." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] }, { "event": "taskCommentUpdated", "path": "/webhooks/clickup/taskCommentUpdated", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "task\_id", "type": "String", "selector": \["task\_id"], "meta": { "description": "ID of the task the comment belongs to." } }, { "name": "comment\_id", "type": "String", "selector": \["history\_items", "0", "comment", "id"], "meta": { "description": "ID of the updated comment." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who updated the comment." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] } ] }, { "handle": "custom\_fields", "meta": { "short": "Custom Fields", "description": "Manage custom fields in ClickUp." }, "endpoint": { "value": "/list/{{list\_id}}/field" }, "fields": \[ { "name": "id", "type": "String", "selector": \[ "id" ], "meta": { "description": "Unique identifier." } }, { "name": "name", "type": "String", "selector": \[ "name" ], "meta": { "description": "Name of the resource." } }, { "name": "date\_created", "type": "String", "selector": \[ "date\_created", "date" ], "meta": { "description": "Creation timestamp." } } ], "operations": { "list": { "method": "GET", "path": { "value": "/team/{{team\_id}}/field" } }, "post": { "method": "POST", "path": { "value": "/task/{{task\_id}}/field/{{field\_id}}" }, "queryParams": { "custom\_task\_ids": { "value": "{{custom\_task\_ids}}" }, "team\_id": { "value": "{{team\_id}}" } } }, "delete": { "method": "DELETE", "path": { "value": "/task/{{task\_id}}/field/{{field\_id}}" }, "queryParams": { "custom\_task\_ids": { "value": "{{custom\_task\_ids}}" }, "team\_id": { "value": "{{team\_id}}" } } } }, "webhooks": \[] }, { "handle": "folders", "meta": { "short": "Folders", "description": "Manage folders in ClickUp." }, "endpoint": { "value": "/space/{{space\_id}}/folder" }, "fields": \[ { "name": "id", "type": "String", "selector": \[ "id" ], "meta": { "description": "Unique identifier." } }, { "name": "name", "type": "String", "selector": \[ "name" ], "meta": { "description": "Name of the resource." } }, { "name": "date\_created", "type": "String", "selector": \[ "date\_created", "date" ], "meta": { "description": "Creation timestamp." } } ], "operations": { "list": { "method": "GET", "path": { "value": "/" }, "queryParams": { "archived": { "value": "{{archived}}" } } }, "post": { "method": "POST", "path": { "value": "\_template/{{template\_id}}" } }, "read": { "method": "GET", "path": { "value": "/folder/{{folder\_id}}" } }, "put": { "method": "PUT", "path": { "value": "/folder/{{folder\_id}}" } }, "delete": { "method": "DELETE", "path": { "value": "/folder/{{folder\_id}}" } } }, "webhooks": \[ { "event": "folderCreated", "path": "/webhooks/clickup/folderCreated", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "folder\_id", "type": "String", "selector": \["folder\_id"], "meta": { "description": "ID of the created folder." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who created the folder." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] }, { "event": "folderUpdated", "path": "/webhooks/clickup/folderUpdated", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "folder\_id", "type": "String", "selector": \["folder\_id"], "meta": { "description": "ID of the updated folder." } }, { "name": "field", "type": "String", "selector": \["history\_items", "0", "field"], "meta": { "description": "Field that changed." } }, { "name": "before", "type": "String", "selector": \["history\_items", "0", "before"], "meta": { "description": "Value before the change." } }, { "name": "after", "type": "String", "selector": \["history\_items", "0", "after"], "meta": { "description": "Value after the change." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who made the change." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] }, { "event": "folderDeleted", "path": "/webhooks/clickup/folderDeleted", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "folder\_id", "type": "String", "selector": \["folder\_id"], "meta": { "description": "ID of the deleted folder." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who deleted the folder." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] } ] }, { "handle": "goals", "meta": { "short": "Goals", "description": "Manage goals in ClickUp." }, "endpoint": { "value": "/team/{{team\_id}}/goal" }, "fields": \[ { "name": "id", "type": "String", "selector": \[ "id" ], "meta": { "description": "Unique identifier." } }, { "name": "name", "type": "String", "selector": \[ "name" ], "meta": { "description": "Name of the resource." } }, { "name": "date\_created", "type": "String", "selector": \[ "date\_created", "date" ], "meta": { "description": "Creation timestamp." } } ], "operations": { "list": { "method": "GET", "path": { "value": "/" }, "queryParams": { "include\_completed": { "value": "{{include\_completed}}" } } }, "post": { "method": "POST", "path": { "value": "/goal/{{goal\_id}}/key\_result" } }, "read": { "method": "GET", "path": { "value": "/goal/{{goal\_id}}" } }, "put": { "method": "PUT", "path": { "value": "/key\_result/{{key\_result\_id}}" } }, "delete": { "method": "DELETE", "path": { "value": "/key\_result/{{key\_result\_id}}" } } }, "webhooks": \[ { "event": "goalCreated", "path": "/webhooks/clickup/goalCreated", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "goal\_id", "type": "String", "selector": \["goal\_id"], "meta": { "description": "ID of the created goal." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who created the goal." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] }, { "event": "goalUpdated", "path": "/webhooks/clickup/goalUpdated", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "goal\_id", "type": "String", "selector": \["goal\_id"], "meta": { "description": "ID of the updated goal." } }, { "name": "field", "type": "String", "selector": \["history\_items", "0", "field"], "meta": { "description": "Field that changed." } }, { "name": "before", "type": "String", "selector": \["history\_items", "0", "before"], "meta": { "description": "Value before the change." } }, { "name": "after", "type": "String", "selector": \["history\_items", "0", "after"], "meta": { "description": "Value after the change." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who made the change." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] }, { "event": "goalDeleted", "path": "/webhooks/clickup/goalDeleted", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "goal\_id", "type": "String", "selector": \["goal\_id"], "meta": { "description": "ID of the deleted goal." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who deleted the goal." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] } ] }, { "handle": "guests", "meta": { "short": "Guests", "description": "Manage guests in ClickUp." }, "endpoint": { "value": "/team/{{team\_id}}/guest" }, "fields": \[ { "name": "id", "type": "String", "selector": \[ "id" ], "meta": { "description": "Unique identifier." } }, { "name": "name", "type": "String", "selector": \[ "name" ], "meta": { "description": "Name of the resource." } }, { "name": "date\_created", "type": "String", "selector": \[ "date\_created", "date" ], "meta": { "description": "Creation timestamp." } } ], "operations": { "post": { "method": "POST", "path": { "value": "/folder/{{folder\_id}}/guest/{{guest\_id}}" }, "queryParams": { "include\_shared": { "value": "{{include\_shared}}" } } }, "read": { "method": "GET", "path": { "value": "/{{guest\_id}}" } }, "put": { "method": "PUT", "path": { "value": "/{{guest\_id}}" } }, "delete": { "method": "DELETE", "path": { "value": "/folder/{{folder\_id}}/guest/{{guest\_id}}" }, "queryParams": { "include\_shared": { "value": "{{include\_shared}}" } } } }, "webhooks": \[] }, { "handle": "lists", "meta": { "short": "Lists", "description": "Manage lists in ClickUp." }, "endpoint": { "value": "/folder/{{folder\_id}}/list" }, "fields": \[ { "name": "id", "type": "String", "selector": \[ "id" ], "meta": { "description": "Unique identifier." } }, { "name": "name", "type": "String", "selector": \[ "name" ], "meta": { "description": "Name of the resource." } }, { "name": "date\_created", "type": "String", "selector": \[ "date\_created", "date" ], "meta": { "description": "Creation timestamp." } } ], "operations": { "list": { "method": "GET", "path": { "value": "/space/{{space\_id}}/list" }, "queryParams": { "archived": { "value": "{{archived}}" } } }, "post": { "method": "POST", "path": { "value": "/space/{{space\_id}}/list\_template/{{template\_id}}" } }, "read": { "method": "GET", "path": { "value": "/list/{{list\_id}}" } }, "put": { "method": "PUT", "path": { "value": "/list/{{list\_id}}" } }, "delete": { "method": "DELETE", "path": { "value": "/list/{{list\_id}}/task/{{task\_id}}" } } }, "webhooks": \[ { "event": "listCreated", "path": "/webhooks/clickup/listCreated", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "list\_id", "type": "String", "selector": \["list\_id"], "meta": { "description": "ID of the created list." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who created the list." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] }, { "event": "listUpdated", "path": "/webhooks/clickup/listUpdated", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "list\_id", "type": "String", "selector": \["list\_id"], "meta": { "description": "ID of the updated list." } }, { "name": "field", "type": "String", "selector": \["history\_items", "0", "field"], "meta": { "description": "Field that changed." } }, { "name": "before", "type": "String", "selector": \["history\_items", "0", "before"], "meta": { "description": "Value before the change." } }, { "name": "after", "type": "String", "selector": \["history\_items", "0", "after"], "meta": { "description": "Value after the change." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who made the change." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] }, { "event": "listDeleted", "path": "/webhooks/clickup/listDeleted", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "list\_id", "type": "String", "selector": \["list\_id"], "meta": { "description": "ID of the deleted list." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who deleted the list." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] } ] }, { "handle": "spaces", "meta": { "short": "Spaces", "description": "Manage spaces in ClickUp." }, "endpoint": { "value": "/team/{{team\_id}}/space" }, "fields": \[ { "name": "id", "type": "String", "selector": \[ "id" ], "meta": { "description": "Unique identifier." } }, { "name": "name", "type": "String", "selector": \[ "name" ], "meta": { "description": "Name of the resource." } }, { "name": "date\_created", "type": "String", "selector": \[ "date\_created", "date" ], "meta": { "description": "Creation timestamp." } } ], "operations": { "list": { "method": "GET", "path": { "value": "/" }, "queryParams": { "archived": { "value": "{{archived}}" } } }, "post": { "method": "POST", "path": { "value": "/" } }, "read": { "method": "GET", "path": { "value": "/space/{{space\_id}}" } }, "put": { "method": "PUT", "path": { "value": "/space/{{space\_id}}" } }, "delete": { "method": "DELETE", "path": { "value": "/space/{{space\_id}}" } } }, "webhooks": \[ { "event": "spaceCreated", "path": "/webhooks/clickup/spaceCreated", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "space\_id", "type": "String", "selector": \["space\_id"], "meta": { "description": "ID of the created space." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who created the space." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] }, { "event": "spaceUpdated", "path": "/webhooks/clickup/spaceUpdated", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "space\_id", "type": "String", "selector": \["space\_id"], "meta": { "description": "ID of the updated space." } }, { "name": "field", "type": "String", "selector": \["history\_items", "0", "field"], "meta": { "description": "Field that changed." } }, { "name": "before", "type": "String", "selector": \["history\_items", "0", "before"], "meta": { "description": "Value before the change." } }, { "name": "after", "type": "String", "selector": \["history\_items", "0", "after"], "meta": { "description": "Value after the change." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who made the change." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] }, { "event": "spaceDeleted", "path": "/webhooks/clickup/spaceDeleted", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "space\_id", "type": "String", "selector": \["space\_id"], "meta": { "description": "ID of the deleted space." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who deleted the space." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] } ] }, { "handle": "tags", "meta": { "short": "Tags", "description": "Manage tags in ClickUp." }, "endpoint": { "value": "/space/{{space\_id}}/tag" }, "fields": \[ { "name": "id", "type": "String", "selector": \[ "id" ], "meta": { "description": "Unique identifier." } }, { "name": "name", "type": "String", "selector": \[ "name" ], "meta": { "description": "Name of the resource." } }, { "name": "date\_created", "type": "String", "selector": \[ "date\_created", "date" ], "meta": { "description": "Creation timestamp." } } ], "operations": { "list": { "method": "GET", "path": { "value": "/" } }, "post": { "method": "POST", "path": { "value": "/task/{{task\_id}}/tag/{{tag\_name}}" }, "queryParams": { "custom\_task\_ids": { "value": "{{custom\_task\_ids}}" }, "team\_id": { "value": "{{team\_id}}" } } }, "put": { "method": "PUT", "path": { "value": "/{{tag\_name}}" } }, "delete": { "method": "DELETE", "path": { "value": "/task/{{task\_id}}/tag/{{tag\_name}}" }, "queryParams": { "custom\_task\_ids": { "value": "{{custom\_task\_ids}}" }, "team\_id": { "value": "{{team\_id}}" } } } }, "webhooks": \[ { "event": "taskTagUpdated", "path": "/webhooks/clickup/taskTagUpdated", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "task\_id", "type": "String", "selector": \["task\_id"], "meta": { "description": "ID of the task whose tags changed." } }, { "name": "tag\_name", "type": "String", "selector": \["history\_items", "0", "after", "name"], "meta": { "description": "Tag name added or removed." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who updated tags." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] } ] }, { "handle": "tasks", "meta": { "short": "Tasks", "description": "Manage tasks in ClickUp." }, "endpoint": { "value": "/list/{{list\_id}}/task" }, "fields": \[ { "name": "id", "type": "String", "selector": \[ "id" ], "meta": { "description": "Unique identifier." } }, { "name": "name", "type": "String", "selector": \[ "name" ], "meta": { "description": "Name of the resource." } }, { "name": "date\_created", "type": "String", "selector": \[ "date\_created", "date" ], "meta": { "description": "Creation timestamp." } } ], "operations": { "list": { "method": "GET", "path": { "value": "/task/bulk\_time\_in\_status/task\_ids" }, "queryParams": { "task\_ids": { "value": "{{task\_ids}}" }, "custom\_task\_ids": { "value": "{{custom\_task\_ids}}" }, "team\_id": { "value": "{{team\_id}}" } } }, "post": { "method": "POST", "path": { "value": "Template/{{template\_id}}" } }, "read": { "method": "GET", "path": { "value": "/task/{{task\_id}}" }, "queryParams": { "custom\_task\_ids": { "value": "{{custom\_task\_ids}}" }, "team\_id": { "value": "{{team\_id}}" }, "include\_subtasks": { "value": "{{include\_subtasks}}" }, "include\_markdown\_description": { "value": "{{include\_markdown\_description}}" }, "custom\_fields": { "value": "{{custom\_fields}}" } } }, "put": { "method": "PUT", "path": { "value": "/task/{{task\_id}}" }, "queryParams": { "custom\_task\_ids": { "value": "{{custom\_task\_ids}}" }, "team\_id": { "value": "{{team\_id}}" } } }, "delete": { "method": "DELETE", "path": { "value": "/task/{{task\_id}}" }, "queryParams": { "custom\_task\_ids": { "value": "{{custom\_task\_ids}}" }, "team\_id": { "value": "{{team\_id}}" } } } }, "webhooks": \[ { "event": "taskCreated", "path": "/webhooks/clickup/taskCreated", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "task\_id", "type": "String", "selector": \["task\_id"], "meta": { "description": "ID of the created task." } }, { "name": "list\_id", "type": "String", "selector": \["history\_items", "0", "parent\_id"], "meta": { "description": "ID of the list the task was created in." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who created the task." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] }, { "event": "taskUpdated", "path": "/webhooks/clickup/taskUpdated", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "task\_id", "type": "String", "selector": \["task\_id"], "meta": { "description": "ID of the updated task." } }, { "name": "field", "type": "String", "selector": \["history\_items", "0", "field"], "meta": { "description": "Field that changed." } }, { "name": "before", "type": "String", "selector": \["history\_items", "0", "before"], "meta": { "description": "Value before the change." } }, { "name": "after", "type": "String", "selector": \["history\_items", "0", "after"], "meta": { "description": "Value after the change." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who made the change." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] }, { "event": "taskDeleted", "path": "/webhooks/clickup/taskDeleted", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "task\_id", "type": "String", "selector": \["task\_id"], "meta": { "description": "ID of the deleted task." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who deleted the task." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] }, { "event": "taskStatusUpdated", "path": "/webhooks/clickup/taskStatusUpdated", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "task\_id", "type": "String", "selector": \["task\_id"], "meta": { "description": "ID of the task." } }, { "name": "status\_before", "type": "String", "selector": \["history\_items", "0", "before", "status"], "meta": { "description": "Status before the change." } }, { "name": "status\_after", "type": "String", "selector": \["history\_items", "0", "after", "status"], "meta": { "description": "Status after the change." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who changed the status." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] }, { "event": "taskPriorityUpdated", "path": "/webhooks/clickup/taskPriorityUpdated", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "task\_id", "type": "String", "selector": \["task\_id"], "meta": { "description": "ID of the task." } }, { "name": "priority\_before", "type": "String", "selector": \["history\_items", "0", "before"], "meta": { "description": "Priority before the change." } }, { "name": "priority\_after", "type": "String", "selector": \["history\_items", "0", "after"], "meta": { "description": "Priority after the change." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who changed the priority." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] }, { "event": "taskAssigneeUpdated", "path": "/webhooks/clickup/taskAssigneeUpdated", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "task\_id", "type": "String", "selector": \["task\_id"], "meta": { "description": "ID of the task." } }, { "name": "assignee\_added", "type": "String", "selector": \["history\_items", "0", "after", "id"], "meta": { "description": "ID of the assignee added (if any)." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who changed the assignee." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] }, { "event": "taskDueDateUpdated", "path": "/webhooks/clickup/taskDueDateUpdated", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "task\_id", "type": "String", "selector": \["task\_id"], "meta": { "description": "ID of the task." } }, { "name": "due\_date\_before", "type": "String", "selector": \["history\_items", "0", "before"], "meta": { "description": "Due date before the change (Unix ms)." } }, { "name": "due\_date\_after", "type": "String", "selector": \["history\_items", "0", "after"], "meta": { "description": "Due date after the change (Unix ms)." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who changed the due date." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] }, { "event": "taskMoved", "path": "/webhooks/clickup/taskMoved", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "task\_id", "type": "String", "selector": \["task\_id"], "meta": { "description": "ID of the moved task." } }, { "name": "list\_id\_before", "type": "String", "selector": \["history\_items", "0", "before", "id"], "meta": { "description": "ID of the list before the move." } }, { "name": "list\_id\_after", "type": "String", "selector": \["history\_items", "0", "after", "id"], "meta": { "description": "ID of the list after the move." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who moved the task." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] }, { "event": "taskCommentPosted", "path": "/webhooks/clickup/taskCommentPosted", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "task\_id", "type": "String", "selector": \["task\_id"], "meta": { "description": "ID of the task." } }, { "name": "comment\_id", "type": "String", "selector": \["history\_items", "0", "comment", "id"], "meta": { "description": "ID of the new comment." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who posted the comment." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] }, { "event": "taskCommentUpdated", "path": "/webhooks/clickup/taskCommentUpdated", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "task\_id", "type": "String", "selector": \["task\_id"], "meta": { "description": "ID of the task." } }, { "name": "comment\_id", "type": "String", "selector": \["history\_items", "0", "comment", "id"], "meta": { "description": "ID of the updated comment." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who updated the comment." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] }, { "event": "taskTimeTrackedUpdated", "path": "/webhooks/clickup/taskTimeTrackedUpdated", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "task\_id", "type": "String", "selector": \["task\_id"], "meta": { "description": "ID of the task." } }, { "name": "time\_before", "type": "String", "selector": \["history\_items", "0", "before"], "meta": { "description": "Time tracked before the change (ms)." } }, { "name": "time\_after", "type": "String", "selector": \["history\_items", "0", "after"], "meta": { "description": "Time tracked after the change (ms)." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who changed tracked time." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] } ] }, { "handle": "time\_entries", "meta": { "short": "Time Tracking", "description": "Manage time tracking in ClickUp." }, "endpoint": { "value": "/team/{{team\_id}}/time\_entries" }, "fields": \[ { "name": "id", "type": "String", "selector": \[ "id" ], "meta": { "description": "Unique identifier." } }, { "name": "name", "type": "String", "selector": \[ "name" ], "meta": { "description": "Name of the resource." } }, { "name": "date\_created", "type": "String", "selector": \[ "date\_created", "date" ], "meta": { "description": "Creation timestamp." } } ], "operations": { "list": { "method": "GET", "path": { "value": "/tags" } }, "post": { "method": "POST", "path": { "value": "/stop" } }, "read": { "method": "GET", "path": { "value": "/{{timer\_id}}" }, "queryParams": { "include\_task\_tags": { "value": "{{include\_task\_tags}}" }, "include\_location\_names": { "value": "{{include\_location\_names}}" }, "include\_approval\_history": { "value": "{{include\_approval\_history}}" }, "include\_approval\_details": { "value": "{{include\_approval\_details}}" } } }, "delete": { "method": "DELETE", "path": { "value": "/tags" } }, "put": { "method": "PUT", "path": { "value": "/tags" } } }, "webhooks": \[ { "event": "taskTimeTrackedUpdated", "path": "/webhooks/clickup/taskTimeTrackedUpdated", "payload": \[ { "name": "event", "type": "String", "selector": \["event"], "meta": { "description": "Event type name." } }, { "name": "webhook\_id", "type": "String", "selector": \["webhook\_id"], "meta": { "description": "Webhook identifier." } }, { "name": "task\_id", "type": "String", "selector": \["task\_id"], "meta": { "description": "ID of the task the time entry belongs to." } }, { "name": "time\_before", "type": "String", "selector": \["history\_items", "0", "before"], "meta": { "description": "Time tracked before the change (ms)." } }, { "name": "time\_after", "type": "String", "selector": \["history\_items", "0", "after"], "meta": { "description": "Time tracked after the change (ms)." } }, { "name": "user\_id", "type": "String", "selector": \["history\_items", "0", "user", "id"], "meta": { "description": "ID of the user who changed tracked time." } }, { "name": "date", "type": "String", "selector": \["history\_items", "0", "date"], "meta": { "description": "Unix timestamp (ms) of the event." } } ] } ] }, { "handle": "users", "meta": { "short": "Users", "description": "Manage users in ClickUp." }, "endpoint": { "value": "/team/{{team\_id}}/user" }, "fields": \[ { "name": "id", "type": "String", "selector": \[ "id" ], "meta": { "description": "Unique identifier." } }, { "name": "name", "type": "String", "selector": \[ "name" ], "meta": { "description": "Name of the resource." } }, { "name": "date\_created", "type": "String", "selector": \[ "date\_created", "date" ], "meta": { "description": "Creation timestamp." } } ], "operations": { "post": { "method": "POST", "path": { "value": "/" } }, "read": { "method": "GET", "path": { "value": "/{{user\_id}}" }, "queryParams": { "include\_shared": { "value": "{{include\_shared}}" } } }, "put": { "method": "PUT", "path": { "value": "/{{user\_id}}" } }, "delete": { "method": "DELETE", "path": { "value": "/{{user\_id}}" } } }, "webhooks": \[] }, { "handle": "views", "meta": { "short": "Views", "description": "Manage views in ClickUp." }, "endpoint": { "value": "/team/{{team\_id}}/view" }, "fields": \[ { "name": "id", "type": "String", "selector": \[ "id" ], "meta": { "description": "Unique identifier." } }, { "name": "name", "type": "String", "selector": \[ "name" ], "meta": { "description": "Name of the resource." } }, { "name": "date\_created", "type": "String", "selector": \[ "date\_created", "date" ], "meta": { "description": "Creation timestamp." } } ], "operations": { "list": { "method": "GET", "path": { "value": "/view/{{view\_id}}/task" }, "queryParams": { "page": { "value": "{{page}}" } } }, "post": { "method": "POST", "path": { "value": "/list/{{list\_id}}/view" } }, "read": { "method": "GET", "path": { "value": "/view/{{view\_id}}" } }, "put": { "method": "PUT", "path": { "value": "/view/{{view\_id}}" } }, "delete": { "method": "DELETE", "path": { "value": "/view/{{view\_id}}" } } }, "webhooks": \[] }, { "handle": "webhooks", "meta": { "short": "Webhooks", "description": "Manage webhooks in ClickUp." }, "endpoint": { "value": "/team/{{team\_id}}/webhook" }, "fields": \[ { "name": "id", "type": "String", "selector": \[ "id" ], "meta": { "description": "Unique identifier." } }, { "name": "name", "type": "String", "selector": \[ "name" ], "meta": { "description": "Name of the resource." } }, { "name": "date\_created", "type": "String", "selector": \[ "date\_created", "date" ], "meta": { "description": "Creation timestamp." } } ], "operations": { "list": { "method": "GET", "path": { "value": "/" } }, "post": { "method": "POST", "path": { "value": "/" } }, "put": { "method": "PUT", "path": { "value": "/webhook/{{webhook\_id}}" } }, "delete": { "method": "DELETE", "path": { "value": "/webhook/{{webhook\_id}}" } } }, "webhooks": \[] } ]
```
Try @Human Buy @Human Subscription Join @Human Community
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.planetcrust.com/human-connections/clickup/clickup.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.