ClickUp
ClickUp Connection

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.
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
Query Operations
Example link
Related Automations
Example link
Obtaining Access Credentials
To obtain a Personal Access Token (PAT) for ClickUp, follow these steps:
Steps:
Log in to your ClickUp account (ensure you have admin permissions if required).
Navigate to Profile Settings:
Click your profile avatar (top-right) → "My Settings".
Go to Apps → "Generate" under Personal Token.
Enter a Token Name (e.g., "System Integration").
Select the scopes (permissions) needed (e.g., full access or granular permissions).
Click "Generate Token".
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
Log in to your ClickUp account.
Select the Space, Folder, or List where you want to implement the webhook.
Click the Automate button (lightning bolt icon) in the upper-right corner.
Select Add Automation.
Choose a Trigger (e.g., "Task created", "Status changed", or "Comment posted").
Select Call webhook as the Action.
Enter the Webhook URL provided by your integration.
(Optional) Add any desired Headers or URL Parameters.
Click Create to save and activate the webhook.
Code (Apache v2.0): Service Connectivity and Metadata
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": [] } ]
Last updated