- Category: productivity
- Auth: OAUTH2, API_KEY
- Composio-managed OAuth available? Yes
- Tools: 165
- Triggers: 21
- Slug:
CLICKUP - Version: 20261101_00
Tools
Add dependency
Add dependency
CLICKUP_ADD_DEPENDENCYAdds a ‘waiting on’ or ‘blocking’ dependency to a task, requiring either depends_on (task becomes waiting on) or dependency_of (task becomes blocking), but not both; team_id is required if custom_task_ids is true.Input Parameters
custom_task_ids is true to look up tasks by custom IDs (unique per team).task_id will depend on (‘waiting on’ relationship). Use this or dependency_of, not both.task_id (‘blocking’ relationship). Use this or depends_on, not both.Output
Add guest to folder
Add guest to folder
CLICKUP_ADD_GUEST_TO_FOLDERAdds a guest to a folder with specified permissions; requires a ClickUp Enterprise Plan.Input Parameters
true, include shared item details (API default if parameter is omitted); if false, exclude them.Output
Add guest to list
Add guest to list
CLICKUP_ADD_GUEST_TO_LISTShares a ClickUp List with an existing guest user, granting them specified permissions; requires the Workspace to be on the ClickUp Enterprise Plan.Input Parameters
false to exclude these details. If not provided or set to true (the API default), shared item details are included.read (view-only), comment (can add comments), edit (can edit existing items), or create (full access, including creating new items).Output
Add guest to task
Add guest to task
CLICKUP_ADD_GUEST_TO_TASKAssigns a guest to a task with specified permissions; requires ClickUp Enterprise Plan, and team_id if custom_task_ids is true.Input Parameters
custom_task_ids is true to correctly identify the task when using a custom task ID.false, details of items already shared with the guest will be excluded. The API defaults to true if this parameter is not explicitly set to false.true if you are referencing the task by its custom task ID. If true, team_id must also be provided.read (view only), comment (view and comment), edit (view, comment, and edit), or create (full permissions).Output
Add tag to task
Add tag to task
CLICKUP_ADD_TAG_TO_TASKAdds an existing tag to a specified task; team_id is required if custom_task_ids is true.Input Parameters
custom_task_ids is set to true.custom_task_ids is set to true. For example: custom_task_ids=true&team_id=123.task_id provided is a custom task ID. If true, the team_id must also be provided.Output
Add task link
Add task link
CLICKUP_ADD_TASK_LINKLinks two existing and accessible ClickUp tasks, identified by task_id (source) and links_to (target).Input Parameters
custom_task_ids is true to identify tasks by custom IDs. For example: custom_task_ids=true&team_id=123.true to indicate that task_id and links_to are custom task IDs rather than standard numerical IDs. If true, team_id must also be provided.Output
Add task to list
Add task to list
Create task attachment
Create task attachment
CLICKUP_ATTACHMENTS_UPLOAD_FILE_TO_TASK_AS_ATTACHMENTDEPRECATED: Use create_task_attachment to upload a file to a task; requires multipart/form-data.Input Parameters
custom_task_ids is true to help locate the task by its custom ID. For example: custom_task_ids=true&team_id=123.true, indicates that task_id should be interpreted as a custom task ID instead of the default ClickUp task ID. If this is true, team_id must also be provided.Output
Update Doc Page
Update Doc Page
CLICKUP_CLICK_UP_UPDATE_DOC_PAGETool to update/edit a ClickUp Doc page’s title and/or content via the v3 Docs API. Use when you need to modify a Doc page’s name or content programmatically.Input Parameters
Output
Create a time entry
Create a time entry
CLICKUP_CREATE_A_TIME_ENTRYCreates a new time entry for a specified team.Input Parameters
stop. The end time of the time entry, as a Unix timestamp in milliseconds. If both start and end are provided, the API will use these to determine the entry’s actual duration, potentially overriding the duration field sent in the request.custom_task_ids is true, this should be the custom task ID.start and stop are provided, the API will use these to determine the entry’s actual duration, potentially overriding the duration field sent in the request.custom_task_ids is set to true. This specifies the team context for the custom task ID. Example: custom_task_ids=true&team_id=123.start and end (or stop) times are also provided in the request, the ClickUp API will calculate the duration based on start and end/stop, and this duration field’s value might be ignored or overridden by the server.true, the tid parameter will be interpreted as a custom task ID. If this is true, the team_id query parameter must also be provided to specify the team context for the custom task ID.Output
Create chat channel
Create chat channel
Create chat message
Create chat message
CLICKUP_CREATE_CHAT_MESSAGETool to send a message in a ClickUp chat channel. Use when you need to post messages to team chat channels. Supports both regular messages and structured posts with optional assignments, followers, and reactions.Input Parameters
Output
Create chat reaction
Create chat reaction
CLICKUP_CREATE_CHAT_REACTIONTool to add a reaction to a ClickUp chat message. Use when you need to react to a message with an emoji.Input Parameters
Output
Create chat view comment
Create chat view comment
CLICKUP_CREATE_CHAT_VIEW_COMMENTPosts a new comment to a specified ClickUp Chat view; the ‘view_id’ must correspond to an existing and accessible Chat view.Input Parameters
True, notifications for this comment will be sent to all members of the Chat view, including the comment creator. If False, notifications will follow standard ClickUp behavior.Output
Create checklist
Create checklist
CLICKUP_CREATE_CHECKLISTCreates a new checklist with a specified name within an existing task, which can be identified by its standard ID or a custom task ID (if custom_task_ids is true, team_id is also required).Input Parameters
custom_task_ids is true).Output
Create checklist item
Create checklist item
CLICKUP_CREATE_CHECKLIST_ITEMCreates a named checklist item within a specified existing checklist, optionally assigning it to a user.Input Parameters
Output
Create direct message channel
Create direct message channel
CLICKUP_CREATE_DIRECT_MESSAGE_CHANNELTool to create a direct message channel in ClickUp. Use when you need to start a direct message conversation with up to 15 users. A Self DM is created when no user IDs are provided.Input Parameters
Output
Create Doc
Create Doc
CLICKUP_CREATE_DOCTool to create a new ClickUp Doc in a Workspace (v3 Docs API) and return the new doc_id for follow-up page/content operations. Use when you need to create a new document in ClickUp.Input Parameters
Output
Create Doc Page
Create Doc Page
CLICKUP_CREATE_DOC_PAGETool to create a page in a ClickUp Doc (v3 Docs API). Use when you need to add a new page to an existing document, either as a root page or as a sub-page under a parent page.Input Parameters
Output
Create folder
Create folder
Create folderless list
Create folderless list
CLICKUP_CREATE_FOLDERLESS_LISTCreates a new folderless list (a list not part of any Folder) directly within a specified ClickUp Space.Input Parameters
due_date includes time (true) or is all-day (false). Required if due_date is set.Output
Create folder view
Create folder view
CLICKUP_CREATE_FOLDER_VIEWCreates a new, highly customizable view within a specific ClickUp folder using its folder_id.Input Parameters
list, board, calendar, table, timeline, workload, activity, map, conversation, or gantt.null (None). It is intended for specifying sort direction within divided sections, but its configuration is not fully detailed.op) values are AND and OR. Required when any filter parameter is provided.null (None). It is intended for view division features (e.g., swimlanes) whose specific configuration via this parameter is not fully detailed.1 for ascending (e.g., urgent priority at top of the view, and tasks with no priority at the bottom) or -1 to reverse the order (e.g., tasks with no priority at the top). Required when any grouping parameter is provided._cf prefix followed by the Custom Field ID (e.g., _cf_xxxxxxxx).none, status, priority, assignee, tag, or dueDate. When any grouping parameter is provided, grouping__field, grouping__dir, grouping__collapsed, and grouping__ignore are all required.true, tasks with no value for the grouping__field will not be grouped and will appear in a separate ‘Ungrouped’ section. Required when any grouping parameter is provided.grouping__field used. Required when any grouping parameter is provided.1 (show subtasks as separate tasks), 2 (expand subtasks under parent tasks), or 3 (collapse subtasks under parent tasks).true, display the List, Folder, and Space location for tasks. When any settings parameter is provided, a complete settings object with all settings keys is required.Output
Create goal
Create goal
Create key result
Create key result
CLICKUP_CREATE_KEY_RESULTCreates a new Key Result (Target) for a specified Goal in ClickUp to define and track measurable objectives towards achieving that Goal.Input Parameters
type is ‘automatic’ to track progress via the completion status of these linked tasks.Output
Create list
Create list
CLICKUP_CREATE_LISTCreates a new list in ClickUp within an existing folder. This action requires a folder_id - lists cannot be created directly in a Space using this action. If you need to create a list directly in a Space (without placing it in a folder), use the ‘CLICKUP_CREATE_FOLDERLESS_LIST’ action with space_id instead.Input Parameters
1695110307000 for September 19, 2023, 07:58:27 AM GMT.due_date includes a specific time. If True, the time component of due_date is respected. If False or not provided, the list is considered due on the entire day specified by due_date.Output
Create list comment
Create list comment
CLICKUP_CREATE_LIST_COMMENTAdds a text comment to a ClickUp List, optionally assigning it to a user and setting the notify-all preference.Input Parameters
Output
Create list from template in folder
Create list from template in folder
Create list view
Create list view
CLICKUP_CREATE_LIST_VIEWCreates a new, customizable view (e.g., list, board, calendar) within a specified ClickUp List, requiring an existing list_id accessible by the user.Input Parameters
list, board, calendar, table, timeline, workload, activity, map, conversation, gantt).1 for ascending (e.g., urgent priority top), -1 for descending (e.g., no priority top).true, enables ‘Me Mode’ for comments, filtering to tasks where the current user is involved in comments.true, enables ‘Me Mode’ for checklists, filtering to tasks with checklists assigned to the current user.1 (separate tasks), 2 (expanded under parent), 3 (collapsed under parent).Output
Create Location Chat Channel
Create Location Chat Channel
Create reply message
Create reply message
Create space
Create space
CLICKUP_CREATE_SPACECreates a new ClickUp Space within a specified Workspace, allowing feature configuration which defaults to Workspace settings if unspecified.Input Parameters
None.None.None.None.None.Output
Create space tag
Create space tag
CLICKUP_CREATE_SPACE_TAGCreates a new tag (name, foreground color, background color) in an existing ClickUp Space.Input Parameters
tag.name field in the API request.tag.tag_bg field in the API request.tag.tag_fg field in the API request.Output
Create space view
Create space view
CLICKUP_CREATE_SPACE_VIEWCreates a customizable view (e.g., List, Board, Gantt) within a specified ClickUp Space, allowing configuration of grouping, sorting, filtering, and display settings.Input Parameters
list, board, calendar, table, timeline, workload, activity, map, conversation, or gantt.None if included, as sort direction for divisions may not be applicable here.AND or OR) for combining filters. When ANY filter parameter is provided, ALL filter fields (op, fields, search, show_closed) are required. Defaults to ‘AND’ if not specified when other filter fields are present.None if included, as division by field may not be applicable for Space views via this action.1 for ascending, -1 for descending. Required when any grouping parameter is provided._cf prefix (e.g., ‘ID_cf’).none, status, priority, assignee, tag, or dueDate. When any grouping parameter is provided, grouping__field, grouping__dir, grouping__collapsed, and grouping__ignore are all required.dueDate, priority). Refer to ClickUp API documentation for a complete list of sortable fields.True, tasks not matching grouping criteria are hidden; otherwise, they are shown in a default group. Required when any grouping parameter is provided.True, closed tasks are included in the view. When ANY filter parameter is provided, ALL filter fields (op, fields, search, show_closed) are required. Defaults to false if not specified when other filter fields are present.True, in ‘Me Mode’, this setting filters for or highlights tasks where the current user has made comments. When ANY settings parameter is provided, ALL settings fields are required. Defaults to false if not specified when other settings fields are present.True, in ‘Me Mode’, this setting filters for or highlights subtasks assigned to the current user. When ANY settings parameter is provided, ALL settings fields are required. Defaults to false if not specified when other settings fields are present.True, displays cover images or image attachments directly on task cards in the view. When ANY settings parameter is provided, ALL settings fields are required. Defaults to true if not specified when other settings fields are present.True, in ‘Me Mode’, this setting filters for or highlights tasks with checklist items assigned to the current user. When ANY settings parameter is provided, ALL settings fields are required. Defaults to false if not specified when other settings fields are present.1 (show as separate tasks), 2 (show expanded under parent task), or 3 (show collapsed under parent task). When ANY settings parameter is provided, ALL settings fields are required. Defaults to 1 if not specified when other settings fields are present.True, displays task assignees in the view (e.g., on task cards). When ANY settings parameter is provided, ALL settings fields are required. Defaults to true if not specified when other settings fields are present.True, displays the task’s location (List, Folder, Space). When ANY settings parameter is provided, ALL settings fields are required. Defaults to false if not specified when other settings fields are present.True, includes closed subtasks in the view according to other filter criteria. When ANY settings parameter is provided, ALL settings fields are required. Defaults to false if not specified when other settings fields are present.True, displays the parent task name next to subtasks for clarity. When ANY settings parameter is provided, ALL settings fields are required. Defaults to false if not specified when other settings fields are present.Output
Create a task
Create a task
CLICKUP_CREATE_TASKCreates a new ClickUp task in a specific list, optionally as a subtask if a parent task ID (which cannot be a subtask itself and must be in the same list) is provided.Input Parameters
null for standard tasks (recommended). Custom task types including Milestones (ID 1) are subject to workspace plan quotas. Only specify a custom_item_id if you have confirmed the workspace has available quota for that task type. Use GET /team/{team_id}/custom_item to check available custom task types and their quotas.Output
Create task attachment
Create task attachment
CLICKUP_CREATE_TASK_ATTACHMENTUploads a file as an attachment to a specified ClickUp task using multipart/form-data.Input Parameters
custom_task_ids is true to help locate the task by its custom ID. For example: custom_task_ids=true&team_id=123.true, indicates that task_id should be interpreted as a custom task ID instead of the default ClickUp task ID. If this is true, team_id must also be provided.Output
Create task comment
Create task comment
CLICKUP_CREATE_TASK_COMMENTAdds a comment to a ClickUp task, assigning it to the supplied user and specifying whether to notify all watchers. Team ID is required when using custom task IDs.Input Parameters
custom_task_ids is true.true, notifications for this comment will be sent to all users watching the task, including the comment’s creator. If false, notifications will be sent according to standard ClickUp notification rules (e.g., to mentioned users, comment assignee).true to indicate that the task_id provided is a custom task ID. If true, the team_id must also be provided.Output
Create task from template
Create task from template
Create team
Create team
CLICKUP_CREATE_TEAMCreates a new team (user group) with specified members in a Workspace; member IDs must be for existing users, and be aware that adding view-only guests as paid members may incur extra charges.Input Parameters
Output
Create threaded comment
Create threaded comment
CLICKUP_CREATE_THREADED_COMMENTTool to create a threaded reply to a comment in ClickUp. Use when you need to respond to an existing comment with context.Input Parameters
Output
Create webhook
Create webhook
CLICKUP_CREATE_WEBHOOKCreates a ClickUp webhook for a Team (Workspace) to notify a public URL on specified events (at least one, or ’*’ for all), optionally scoped to a Space, Folder, List, or Task; the endpoint must accept requests from dynamic IPs.Input Parameters
Output
Create workspace Everything level view
Create workspace Everything level view
CLICKUP_CREATE_WORKSPACE_EVERYTHING_LEVEL_VIEWCreates a new, customizable view (e.g., List, Board) at the ‘Everything’ level for a specified Team (Workspace ID), encompassing all tasks within that Workspace.Input Parameters
_cf. For specific configurations, use a JSON object string.Output
Delete chat channel
Delete chat channel
Delete chat message
Delete chat message
Delete chat reaction
Delete chat reaction
CLICKUP_DELETE_CHAT_REACTIONTool to delete a reaction from a chat message in ClickUp. Use when you need to remove an emoji reaction that was previously added to a chat message.Input Parameters
Output
Delete checklist
Delete checklist
Delete checklist item
Delete checklist item
Delete comment
Delete comment
Delete dependency
Delete dependency
CLICKUP_DELETE_DEPENDENCYRemoves a dependency relationship for a task. Provide exactly one of: depends_on to remove a ‘waiting on’ dependency (task_id is blocked by another task), or dependency_of to remove a ‘blocking’ dependency (another task is blocked by task_id). team_id is required if custom_task_ids is true.Input Parameters
task_id depends on (i.e., task_id is waiting on this task). Provide this to remove a ‘waiting on’ dependency. Mutually exclusive with dependency_of - exactly one must be provided.task_id (i.e., this task is blocked by task_id). Provide this to remove a ‘blocking’ dependency. Mutually exclusive with depends_on - exactly one must be provided.task_id and the dependency task ID as custom task IDs; team_id also required.Output
Delete folder
Delete folder
Delete goal
Delete goal
Delete key result
Delete key result
Delete list
Delete list
CLICKUP_DELETE_LISTPermanently deletes an existing List and all its contents; this action is destructive and irreversible via the API.Input Parameters
Output
Delete space
Delete space
Delete space tag
Delete space tag
CLICKUP_DELETE_SPACE_TAGDeletes a Tag from a Space, identified by tag_name in path; precise matching of Tag details in the request body (tag_name_1, tag_tag_fg, tag_tag_bg) is generally required for successful deletion.Input Parameters
Output
Delete task
Delete task
CLICKUP_DELETE_TASKPermanently deletes a task, using its standard ID or a custom task ID (requires custom_task_ids=true and team_id).Input Parameters
custom_task_ids must be true).custom_task_ids is true to identify the team for the custom task ID.Output
Delete task link
Delete task link
CLICKUP_DELETE_TASK_LINKDeletes an existing link, effectively a dependency or relationship, between two ClickUp tasks; set custom_task_ids=true and provide team_id if using custom task IDs.Input Parameters
custom_task_ids is true, this should be its custom task ID.custom_task_ids is set to true to correctly scope the custom task IDs. For example: custom_task_ids=true&team_id=123.custom_task_ids is true, this should be its custom task ID.task_id and links_to refer to custom task IDs (rather than standard ClickUp task IDs), this parameter must be set to true. Setting this to true also requires team_id to be provided. Defaults to false if not specified.Output
Delete team
Delete team
Delete a time entry
Delete a time entry
Delete time tracked
Delete time tracked
CLICKUP_DELETE_TIME_TRACKEDDeletes a time-tracked interval from a task; use this legacy endpoint for older time tracking systems.Input Parameters
custom_task_ids is set to true to correctly identify the task using its custom ID. For example: custom_task_ids=true&team_id=123.true if task_id refers to a custom task ID. If true, team_id must also be provided. If omitted or false, task_id is treated as a standard ID.Output
Delete view
Delete view
Delete webhook
Delete webhook
Get accessible custom fields
Get accessible custom fields
Get access token
Get access token
Get bulk tasks time in status
Get bulk tasks time in status
CLICKUP_GET_BULK_TASKS_TIME_IN_STATUSRetrieves the time spent in each status for multiple tasks; requires the ‘Total time in Status’ ClickApp to be enabled in the Workspace.Input Parameters
custom_task_ids parameter is set to true.true if task_ids refer to custom task IDs instead of standard task IDs. If true, team_id must also be provided.Output
Get chat channel
Get chat channel
Get chat channel followers
Get chat channel followers
Get chat channel members
Get chat channel members
Get chat channels
Get chat channels
CLICKUP_GET_CHAT_CHANNELSTool to retrieve chat channels in a ClickUp workspace. Use when you need to list available chat channels, DMs, or group chats in a workspace. Supports pagination via cursor and filtering by follower status, closed channels, and recent activity.Input Parameters
Output
Get chat message reactions
Get chat message reactions
CLICKUP_GET_CHAT_MESSAGE_REACTIONSTool to retrieve reactions on a ClickUp chat message. Use when you need to see who reacted to a message and with what emoji.Input Parameters
next_cursor from the previous response to paginate through reactions.Output
Get chat message replies
Get chat message replies
Get chat messages
Get chat messages
Get chat message tagged users
Get chat message tagged users
Get chat view comments
Get chat view comments
CLICKUP_GET_CHAT_VIEW_COMMENTSRetrieves comments from a specified Chat view in ClickUp, supporting pagination via start and start_id to fetch comments older than the default 25 most recent.Input Parameters
start_id.start to retrieve comments after this ID that also meet the start time condition.Output
Get custom roles
Get custom roles
Get custom task types
Get custom task types
Get Doc
Get Doc
Get Doc Content
Get Doc Content
CLICKUP_GET_DOC_CONTENTFetches a ClickUp Doc’s metadata and page content, with options to select pages or return a page listing without content. Page content is returned in a markdown field when available.Input Parameters
Output
Get Doc Page Content
Get Doc Page Content
CLICKUP_GET_DOC_PAGE_CONTENTTool to fetch a single ClickUp Doc page’s content and metadata by workspace_id + doc_id + page_id (v3 Docs API). Use when you need to read the content of a specific page without fetching the entire Doc.Input Parameters
Output
Get Doc Page Listing
Get Doc Page Listing
CLICKUP_GET_DOC_PAGE_LISTINGTool to fetch the page listing structure of a ClickUp Doc by workspace_id and doc_id. Use when you need to discover the hierarchical structure of pages and subpages within a Doc without fetching the actual content.Input Parameters
Output
Get Doc Pages
Get Doc Pages
CLICKUP_GET_DOC_PAGES_PUBLICTool to fetch pages belonging to a ClickUp Doc. Use when you need to list all pages in a doc with their content and structure.Input Parameters
Output
Get filtered team tasks
Get filtered team tasks
CLICKUP_GET_FILTERED_TEAM_TASKSRetrieves a paginated, filtered list of workspace tasks, subject to user access; keyword/text search is not supported. Results contain trimmed task fields and descriptions limited to 200 characters, without comments.Input Parameters
last_page field is true or the returned tasks list is empty to avoid silently missing tasks.custom_task_ids is true, for custom task ID context. Distinct from the required team_Id path parameter (Workspace ID); do not confuse these — this optional numeric string is only used for custom task ID resolution. Example: ‘9001’.field_id values or unsupported operator strings produce 400 errors or silently empty results; retrieve valid field_ids from workspace custom field configuration.team_id for context.Output
Get folder
Get folder
Get Folder Available Fields
Get Folder Available Fields
Get folderless lists
Get folderless lists
Get folders
Get folders
Get folder views
Get folder views
Get goal
Get goal
Get goals
Get goals
Get guest
Get guest
Get list
Get list
CLICKUP_GET_LISTRetrieves detailed information for an existing List in ClickUp, identified by its unique list_id.Input Parameters
Output
Get list comments
Get list comments
Get list members
Get list members
Get lists
Get lists
Get list views
Get list views
Get running time entry
Get running time entry
Get space
Get space
Get space available fields
Get space available fields
Get spaces
Get spaces
Get space views
Get space views
Get post subtype IDs
Get post subtype IDs
CLICKUP_GET_SUBTYPESTool to retrieve post subtype IDs (Announcement, Discussion, Idea, Update) for a ClickUp Workspace. Use when you need subtype IDs to send messages with type: post.Input Parameters
Output
Get task
Get task
CLICKUP_GET_TASKRetrieves comprehensive details for a ClickUp task by its ID, supporting standard or custom task IDs (requires team_id for custom IDs).Input Parameters
custom_task_ids is set to true (in which case team_id is also required).custom_task_ids is set to true to identify the custom task ID within that specific team. For example: custom_task_ids=true&team_id=123.true to indicate that the task_id provided is a custom task ID. If true, team_id must also be provided. If omitted or false (default), task_id is treated as a standard task ID.true to include subtasks in the task details response. If omitted or false (default), subtasks are not included.true to return the task description in Markdown format. If omitted or false (default), the description is returned in plain text. For example: ?include_markdown_description=true.Output
Get task comments
Get task comments
CLICKUP_GET_TASK_COMMENTSRetrieves up to 25 comments for a specified task, supporting pagination using start and start_id to fetch older comments.Input Parameters
start_id for paginating older comments.custom_task_ids is true).Output
Get task members
Get task members
Get tasks
Get tasks
CLICKUP_GET_TASKSRetrieves tasks from a specified ClickUp list; only tasks whose home is the given list_id are returned, and closed and archived tasks are excluded by default. Key task attributes may appear in custom_fields, and folder may be absent; high-volume calls may return HTTP 429.Input Parameters
last_page flag is true or the returned tasks list is empty to avoid silently missing tasks.include_closed parameter. Values must match workspace configuration exactly (case-sensitive, including spacing); mismatches return empty results silently.?custom_items[]=0&custom_items[]=1300. Including 0 returns tasks. Including 1 returns Milestones. Including any other number returns the custom task type as defined in your Workspace.text_content field instead when plain text is needed.Output
Get task templates
Get task templates
Get task s time in status
Get task s time in status
CLICKUP_GET_TASK_TIME_IN_STATUSRetrieves the duration a task has spent in each status, provided the ‘Total time in Status’ ClickApp is enabled for the Workspace.Input Parameters
custom_task_ids is true.custom_task_ids is set to true. For example: custom_task_ids=true&team_id=1234567.true, the task_id parameter will be interpreted as a custom task ID. When using custom task IDs, the team_id must also be provided.Output
Get team available fields
Get team available fields
Get teams
Get teams
CLICKUP_GET_TEAMSRetrieves user groups (Teams) from a ClickUp Workspace, typically requiring team_id (Workspace ID), with an option to filter by group_ids.Input Parameters
Output
Get threaded comments
Get threaded comments
Get time entries within a date range
Get time entries within a date range
CLICKUP_GET_TIME_ENTRIES_IN_DATE_RANGERetrieves time entries for a specified Team (Workspace ID) within a date range (defaults to the last 30 days for the authenticated user if dates are omitted); active timers are indicated by negative durations in the response.Input Parameters
custom_task_ids if referring to a custom ID.custom_task_ids is true. This helps resolve custom task IDs. Example: custom_task_ids=true&team_id=123.1234,9876. Note: Access to other users’ time entries typically requires Workspace Owner/Admin privileges.true if the task_id parameter refers to a custom task ID. If true, the team_id query parameter must also be provided for context.list_id, folder_id, space_id).Output
Get singular time entry
Get singular time entry
CLICKUP_GET_TIME_ENTRYFetches a specific time entry by its ID for a given team; a negative duration in the response indicates an active timer.Input Parameters
Output
Get time entry history
Get time entry history
Get tracked time
Get tracked time
CLICKUP_GET_TRACKED_TIMERetrieves tracked time for a task using a legacy endpoint; prefer newer Time Tracking API endpoints for managing time entries.Input Parameters
custom_task_ids is set to true.custom_task_ids parameter is set to true. For example: custom_task_ids=true&team_id=123.true if the task_id provided is a custom task ID. If true, the team_id must also be provided.Output
Get user
Get user
Get view
Get view
Get view tasks
Get view tasks
CLICKUP_GET_VIEW_TASKSRetrieves a page of tasks from a specified ClickUp view, respecting its applied filters, sorting, and grouping. The response indicates whether it is the last page.Input Parameters
Output
Get webhooks
Get webhooks
CLICKUP_GET_WEBHOOKSFetches webhooks for a Team (Workspace), returning only those created by the authenticated user via API, for a team_id they can access.Input Parameters
Output
Get workspace everything level views
Get workspace everything level views
CLICKUP_GET_WORKSPACE_EVERYTHING_LEVEL_VIEWSRetrieves all task and page views at the ‘Everything Level’ (a comprehensive overview of all tasks across all Spaces) for a specified ClickUp Workspace.Input Parameters
Output
Get workspace plan
Get workspace plan
Get workspace seats
Get workspace seats
Invite guest to workspace
Invite guest to workspace
CLICKUP_INVITE_GUEST_TO_WORKSPACEInvites a guest by email to a ClickUp Workspace (Team) on an Enterprise Plan, setting initial permissions and optionally a custom role; further access configuration for specific items may require separate actions.Input Parameters
Output
Invite user to workspace
Invite user to workspace
CLICKUP_INVITE_USER_TO_WORKSPACEInvites a user via email to a ClickUp Workspace (Team), optionally granting admin rights or a custom role; requires an Enterprise Plan for the Workspace.Input Parameters
Output
Move task to new home list
Move task to new home list
CLICKUP_MOVE_TASK_TO_HOME_LISTTool to move a task to a new home List using ClickUp Public API v3. Use when you need to change a task’s home list (not just add to additional lists).Input Parameters
Output
Remove custom field value
Remove custom field value
CLICKUP_REMOVE_CUSTOM_FIELD_VALUERemoves an existing value from a Custom Field on a specific task; this does not delete the Custom Field definition or its predefined options.Input Parameters
custom_task_ids is true, this is the custom task ID; otherwise, it’s the standard task ID.custom_task_ids is true to identify the task by its custom ID.Output
Remove guest from folder
Remove guest from folder
Remove guest from list
Remove guest from list
Remove guest from task
Remove guest from task
CLICKUP_REMOVE_GUEST_FROM_TASKRevokes a guest’s access to a specific task; only available for Workspaces on the ClickUp Enterprise Plan.Input Parameters
custom_task_ids is set to true.custom_task_ids is set to true and you are using a custom task ID. For example: custom_task_ids=true&team_id=123.false to exclude these details. Defaults to true.true if you are using a custom task ID for the task_id parameter. If true, team_id must also be provided.Output
Remove guest from workspace
Remove guest from workspace
CLICKUP_REMOVE_GUEST_FROM_WORKSPACEPermanently removes a guest from a specified Workspace, revoking all their access; this destructive operation requires the Workspace to be on the ClickUp Enterprise Plan.Input Parameters
Output
Remove tag from task
Remove tag from task
CLICKUP_REMOVE_TAG_FROM_TASKRemoves a tag from a specified task by disassociating it (does not delete the tag from Workspace), succeeding even if the tag is not on the task.Input Parameters
custom_task_ids is set to true.true if you are using a custom task ID (instead of the default task ID) to identify the task. If true, the team_id must also be provided.Output
Remove task from list
Remove task from list
CLICKUP_REMOVE_TASK_FROM_LISTRemoves a task from an extra list (not its home list); the ‘Tasks in Multiple Lists’ ClickApp must be enabled.Input Parameters
Output
Remove user from workspace
Remove user from workspace
CLICKUP_REMOVE_USER_FROM_WORKSPACEDeactivates a user from a specified ClickUp Workspace, revoking their access (user can be reactivated later); requires the Workspace to be on an Enterprise Plan.Input Parameters
Output
Search Docs
Search Docs
Set custom field value
Set custom field value
CLICKUP_SET_CUSTOM_FIELD_VALUESets or updates a Custom Field’s value for a task; the new value (with type-dependent structure, e.g., {"value": "text"} or {"value": 123, "value_options": {"currency_type":"USD"}}) is provided in the JSON request body.Input Parameters
Output
Start a time entry
Start a time entry
CLICKUP_START_TIME_ENTRYStarts a new time entry (timer) in the specified Team (Workspace), optionally associating it with a task, adding a description, setting billable status, or applying tags (tags feature requires Business Plan or higher).Input Parameters
custom_task_ids is true, this should be the custom task ID.[{"name": "Urgent", "tag_bg": "#FF0000"}].custom_task_ids is set to true. For example: custom_task_ids=true&team_id=123.true, the tid field will be interpreted as a custom task ID. Requires team_id query parameter to be set for custom task ID resolution.Output
Stop a time entry
Stop a time entry
Track time
Track time
CLICKUP_TRACK_TIMERecords a time entry for a task using ClickUp’s legacy time tracking system; newer endpoints are generally recommended.Input Parameters
start and end are both provided, this time field is ignored. If time is passed with start but no end, then end will be calculated. If time is passed with end but no start, then start will be calculated.custom_task_ids is set to true to identify the task by its custom ID. For example: custom_task_ids=true&team_id=123.Output
Update chat channel
Update chat channel
Update chat message
Update chat message
CLICKUP_UPDATE_CHAT_MESSAGETool to update a ClickUp chat message’s content, assignee, or resolved status via the v3 API. Use when you need to edit an existing chat message.Input Parameters
Output
Edit checklist
Edit checklist
Edit checklist item
Edit checklist item
CLICKUP_UPDATE_CHECKLIST_ITEMUpdates an existing checklist item, allowing modification of its name, assignee, resolution status, or parent item for nesting.Input Parameters
Output
Update comment
Update comment
Update folder
Update folder
Update goal
Update goal
Edit guest on workspace
Edit guest on workspace
CLICKUP_UPDATE_GUEST_ON_WORKSPACEModifies the details and permissions of an existing guest user within a specific Workspace.Input Parameters
Output
Edit key result
Edit key result
Update list
Update list
CLICKUP_UPDATE_LISTUpdates attributes of an existing ClickUp list, such as its name, content, due date, priority, assignee, or color status, identified by its list_id.Input Parameters
1672531199000 for Dec 31, 2022, 11:59:59 PM UTC).true to remove the list’s color, overriding status; if false, status updates or maintains current color.Output
Update space
Update space
CLICKUP_UPDATE_SPACEUpdates a ClickUp Space’s name, color, privacy, multiple-assignee setting, and optionally its feature settings (ClickApps). The name, color, privacy, and multiple-assignee setting are required.Input Parameters
Output
Edit space tag
Edit space tag
Update task
Update task
CLICKUP_UPDATE_TASKUpdates attributes of an existing task; team_id is required if custom_task_ids is true, use a single space (” ”) for description to clear it, and provide at least one modifiable field.Input Parameters
1 for Milestone, its ID for custom type. Omit/None to make regular task (API’s ‘null’ equivalent).Output
Update team
Update team
Update a time entry
Update a time entry
CLICKUP_UPDATE_TIME_ENTRYUpdates an existing ClickUp time entry. Requires team_id (workspace ID) and timer_id (time entry ID). Optional fields: description, tags, tag_action, start/end times, duration, tid (task ID), billable status. Note: start and end times should be provided together. This is an Advanced Time Tracking feature that may require a Business Plan or higher.Input Parameters
custom_task_ids is true, this should be the custom task ID.{'name': 'your-tag'}) for the time entry. Time tracking labels are for Business Plan and above users.start and end times.true, tid is interpreted as a custom task ID. When true, the team_id path parameter value will also be used as a query parameter.Output
Change tag names from time entries
Change tag names from time entries
Edit time tracked
Edit time tracked
CLICKUP_UPDATE_TIME_TRACKEDEdits a legacy time-tracked interval for a task (identified by task_id and interval_id) to update its start/end times and duration; team_id is required if custom_task_ids is true.Input Parameters
end and start.Output
Edit user on workspace
Edit user on workspace
CLICKUP_UPDATE_USER_ON_WORKSPACEUpdates a user’s username, admin status, or custom role in a Workspace; requires the Workspace to be on an Enterprise Plan.Input Parameters
true to make user an admin, false to revoke admin privileges. Optional - only include if you want to change admin status.Output
Update view
Update view
CLICKUP_UPDATE_VIEWUpdates an existing ClickUp view’s settings such as name, type, grouping, or filters; ensure parent_id and parent_type define a valid hierarchy, and that specified field names (e.g. for sorting, columns) are valid within the ClickUp workspace.Input Parameters
7, Space: 4, Folder: 5, List: 6.1 for ascending (e.g., urgent priority at the top) or -1 for descending (e.g., no priority at the top)._cf prefix and their ID (e.g., _cf_custom_field_id).none, status, priority, assignee, tag, or dueDate.1 (show subtasks as separate tasks), 2 (show subtasks expanded under parent task), or 3 (show subtasks collapsed under parent task).Output
Update webhook
Update webhook
CLICKUP_UPDATE_WEBHOOKUpdates the endpoint URL, monitored events, and status of an existing webhook, identified by its webhook_id.Input Parameters
Output
Update workspace ACL
Update workspace ACL
CLICKUP_UPDATE_WORKSPACE_ACLUpdates privacy and access control list (ACL) permissions for a workspace object or location. Use this to make objects private/public or manage user/team permissions for spaces, folders, lists, tasks, and other ClickUp objects.Input Parameters
Output
Triggers
Folder Created
Folder Created
Folder Deleted
Folder Deleted
Folder Updated
Folder Updated
List Created
List Created
CLICKUP_LIST_CREATEDType: webhookTriggers when a new List is created.Configuration
CLICKUP_GET_FOLDERS to discover valid Folder IDs.CLICKUP_GET_SPACES to discover valid Space IDs.team_id). Use CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES to discover valid Workspace IDs.Payload
List Deleted
List Deleted
CLICKUP_LIST_DELETEDType: webhookTriggers when a List is deleted.Configuration
CLICKUP_GET_FOLDERS to discover valid Folder IDs.CLICKUP_GET_SPACES to discover valid Space IDs.team_id). Use CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES to discover valid Workspace IDs.Payload
List Updated
List Updated
CLICKUP_LIST_UPDATEDType: webhookTriggers when a List is updated (renamed, content edited, etc.).Configuration
CLICKUP_GET_FOLDERS to discover valid Folder IDs.CLICKUP_GET_SPACES to discover valid Space IDs.team_id). Use CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES to discover valid Workspace IDs.Payload
NameChange (rename). Each change carries its own actor and occurred_at.Space Created
Space Created
Space Deleted
Space Deleted
Space Updated
Space Updated
Task Assignee Updated
Task Assignee Updated
CLICKUP_TASK_ASSIGNEE_UPDATEDType: webhookTriggers when an assignee is added to or removed from a task.changes[] carries AssigneeAddChange and/or AssigneeRemoveChange entries. A single event may bundle multiple adds and/or removes — for example when a workflow re-routes a task between two users in one operation.Configuration
CLICKUP_GET_FOLDERS to discover valid Folder IDs.CLICKUP_GET_LISTS (or CLICKUP_GET_FOLDERLESS_LISTS for folderless lists) to discover valid List IDs.CLICKUP_GET_SPACES to discover valid Space IDs.team_id). Use CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES to discover valid Workspace IDs.Payload
field — match on isinstance() or check change.field to read the typed value. Each change carries its own actor and occurred_at.Task Comment Posted
Task Comment Posted
CLICKUP_TASK_COMMENT_POSTEDType: webhookTriggers when a comment is added to a task.changes[] carries one CommentChange entry whose comment field is the typed ClickupComment object (id, text, user, reactions, etc.).Configuration
CLICKUP_GET_FOLDERS to discover valid Folder IDs.CLICKUP_GET_LISTS (or CLICKUP_GET_FOLDERLESS_LISTS for folderless lists) to discover valid List IDs.CLICKUP_GET_SPACES to discover valid Space IDs.team_id). Use CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES to discover valid Workspace IDs.Payload
field — match on isinstance() or check change.field to read the typed value. Each change carries its own actor and occurred_at.Task Comment Updated
Task Comment Updated
CLICKUP_TASK_COMMENT_UPDATEDType: webhookTriggers when an existing comment on a task is edited.changes[] carries one CommentChange entry whose comment field is the comment in its updated form.Configuration
CLICKUP_GET_FOLDERS to discover valid Folder IDs.CLICKUP_GET_LISTS (or CLICKUP_GET_FOLDERLESS_LISTS for folderless lists) to discover valid List IDs.CLICKUP_GET_SPACES to discover valid Space IDs.team_id). Use CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES to discover valid Workspace IDs.Payload
field — match on isinstance() or check change.field to read the typed value. Each change carries its own actor and occurred_at.Task Created
Task Created
CLICKUP_TASK_CREATEDType: webhookTriggers when a new task is created in the configured Workspace.Configuration
CLICKUP_GET_FOLDERS to discover valid Folder IDs.CLICKUP_GET_LISTS (or CLICKUP_GET_FOLDERLESS_LISTS for folderless lists) to discover valid List IDs.CLICKUP_GET_SPACES to discover valid Space IDs.team_id). Use CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES to discover valid Workspace IDs.Payload
role, role_subtype, color, initials, profile_picture_key) is dropped on output.before/after values. Webhook status objects omit the id that GET /task ships, and status can be null to represent the “no prior status” side of a creation event.Task Deleted
Task Deleted
CLICKUP_TASK_DELETEDType: webhookTriggers when a task is deleted.ClickUp ships no history_items or actor info on deletes — the payload carries only the task_id and team_id.Configuration
CLICKUP_GET_FOLDERS to discover valid Folder IDs.CLICKUP_GET_LISTS (or CLICKUP_GET_FOLDERLESS_LISTS for folderless lists) to discover valid List IDs.CLICKUP_GET_SPACES to discover valid Space IDs.team_id). Use CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES to discover valid Workspace IDs.Payload
Task Due Date Updated
Task Due Date Updated
CLICKUP_TASK_DUE_DATE_UPDATEDType: webhookTriggers when a task’s due date is set, changed, or cleared.changes[] carries DueDateChange entries only; before and after are millisecond-epoch strings or null.Configuration
CLICKUP_GET_FOLDERS to discover valid Folder IDs.CLICKUP_GET_LISTS (or CLICKUP_GET_FOLDERLESS_LISTS for folderless lists) to discover valid List IDs.CLICKUP_GET_SPACES to discover valid Space IDs.team_id). Use CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES to discover valid Workspace IDs.Payload
field — match on isinstance() or check change.field to read the typed value. Each change carries its own actor and occurred_at.Task Priority Updated
Task Priority Updated
CLICKUP_TASK_PRIORITY_UPDATEDType: webhookTriggers when a task’s priority changes.changes[] carries PriorityChange entries only.Configuration
CLICKUP_GET_FOLDERS to discover valid Folder IDs.CLICKUP_GET_LISTS (or CLICKUP_GET_FOLDERLESS_LISTS for folderless lists) to discover valid List IDs.CLICKUP_GET_SPACES to discover valid Space IDs.team_id). Use CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES to discover valid Workspace IDs.Payload
field — match on isinstance() or check change.field to read the typed value. Each change carries its own actor and occurred_at.Task Status Updated
Task Status Updated
CLICKUP_TASK_STATUS_UPDATEDType: webhookTriggers when a task’s status changes.changes[] carries StatusChange entries only — ClickUp pre-filters server-side by event type. Lower traffic than subscribing to CLICKUP_TASK_UPDATED and pattern-matching StatusChange.Configuration
CLICKUP_GET_FOLDERS to discover valid Folder IDs.CLICKUP_GET_LISTS (or CLICKUP_GET_FOLDERLESS_LISTS for folderless lists) to discover valid List IDs.CLICKUP_GET_SPACES to discover valid Space IDs.team_id). Use CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES to discover valid Workspace IDs.Payload
field — match on isinstance() or check change.field to read the typed value. Each change carries its own actor and occurred_at.Task Tag Updated
Task Tag Updated
CLICKUP_TASK_TAG_UPDATEDType: webhookTriggers when a tag is added to or removed from a task.changes[] carries TagAddChange and/or TagRemoveChange entries. Adds use ClickUp’s field == "tag", removes use the undocumented field == "tag_removed"; both are normalised into the typed change classes.Configuration
CLICKUP_GET_FOLDERS to discover valid Folder IDs.CLICKUP_GET_LISTS (or CLICKUP_GET_FOLDERLESS_LISTS for folderless lists) to discover valid List IDs.CLICKUP_GET_SPACES to discover valid Space IDs.team_id). Use CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES to discover valid Workspace IDs.Payload
field — match on isinstance() or check change.field to read the typed value. Each change carries its own actor and occurred_at.Task Time Estimate Updated
Task Time Estimate Updated
CLICKUP_TASK_TIME_ESTIMATE_UPDATEDType: webhookTriggers when a task’s time estimate is set, changed, or cleared.changes[] carries TimeEstimateChange entries only; before and after are millisecond strings or null.Configuration
CLICKUP_GET_FOLDERS to discover valid Folder IDs.CLICKUP_GET_LISTS (or CLICKUP_GET_FOLDERLESS_LISTS for folderless lists) to discover valid List IDs.CLICKUP_GET_SPACES to discover valid Space IDs.team_id). Use CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES to discover valid Workspace IDs.Payload
field — match on isinstance() or check change.field to read the typed value. Each change carries its own actor and occurred_at.Task Time Tracked Updated
Task Time Tracked Updated
CLICKUP_TASK_TIME_TRACKED_UPDATEDType: webhookTriggers when a time-tracking interval is created, edited, or deleted on a task.Fires once per interval-change. Reads ClickUp’s top-level data.description for the lifecycle action and data.interval_id for the correlation key — these are unique to time-tracking events and are present even on Deleted (where history_items is empty).Configuration
CLICKUP_GET_FOLDERS to discover valid Folder IDs.CLICKUP_GET_LISTS (or CLICKUP_GET_FOLDERLESS_LISTS for folderless lists) to discover valid List IDs.CLICKUP_GET_SPACES to discover valid Space IDs.team_id). Use CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES to discover valid Workspace IDs.Payload
role, role_subtype, color, initials, profile_picture_key) is dropped on output.after. Only this fixed set of fields ships in the webhook; description, billable, tags, and task_location require CLICKUP_GET_TIME_ENTRY.Task Updated
Task Updated
CLICKUP_TASK_UPDATEDType: webhookTriggers when a task is updated.Fires for every kind of update on the task, including comments. If you only care about a specific property changing, prefer the dedicated trigger (CLICKUP_TASK_STATUS_UPDATED, etc.) — those are pre-filtered by ClickUp and produce less traffic.changes[] can carry any FieldChange variant (StatusChange, PriorityChange, AssigneeAddChange, AssigneeRemoveChange, TagAddChange, TagRemoveChange, DueDateChange, TimeEstimateChange, TimeSpentChange, NameChange, ContentChange, CommentChange, CustomFieldChange).Configuration
CLICKUP_GET_FOLDERS to discover valid Folder IDs.CLICKUP_GET_LISTS (or CLICKUP_GET_FOLDERLESS_LISTS for folderless lists) to discover valid List IDs.CLICKUP_GET_SPACES to discover valid Space IDs.team_id). Use CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES to discover valid Workspace IDs.Payload
field — match on isinstance() or check change.field to read the typed value. Each change carries its own actor and occurred_at.