DEV

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

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

Action: Send Direct Message

Action: Create new Document

Action: Create Space

Query Operations

Example link

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

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