> ## Documentation Index > Fetch the complete documentation index at: https://squad.so/docs/llms.txt > Use this file to discover all available pages before exploring further. # ClickUp > What agents can do in ClickUp with standard access, and how to connect, limit, and disconnect ClickUp. Connect ClickUp so your agents can work in your ClickUp account. ## Access levels ClickUp has one level. The connect window shows it as **Default** and describes it as "Standard access." Agents can use all 164 ClickUp actions. You cannot choose a narrower level for ClickUp. You can block single agents with **No access** under **Per-agent access**. The ClickUp sign-in page asks you to approve full access to your account. This is expected. Squad does not narrow the sign-in, and standard access does not limit which ClickUp actions agents can use. ## What agents can do The summary below groups the ClickUp actions into plain tasks. The full list after it names every action, grouped by what the action works on. You do not need to name actions. Ask in plain words, and the agent searches for the matching action. **Find an action.** Open the list and use your browser's find (Ctrl+F, or Cmd+F on a Mac) with a word from the task or part of a slug. Or ask your agent in plain words, for example "What can you do in my ClickUp account?" The agent can search the ClickUp actions for you. Each action shows its name, a one-line description where the ClickUp action catalog has one, and its slug. The slug is the ID that agents use when they call the action. * View, create, update, and delete views * View, create, update, and delete comments * View, create, update, and delete lists * View, create, update, and delete tasks * View, create, update, delete, start, and stop time entries * View, create, update, and delete channels * View, create, update, and delete tags * View, create, update, and delete folders * View, create, update, and delete goals * View, update, delete, and send messages * View, create, update, and delete spaces * View, create, and update users | Action | What it does | Slug | | ---------------------- | -------------------------------------------------------------------------------------- | -------------------------------- | | Create task attachment | Uploads a file as an attachment to a specified ClickUp task using multipart/form-data. | `CLICKUP_CREATE_TASK_ATTACHMENT` | | Action | What it does | Slug | | ----------------------------- | -------------------------------------------------------------------------------------------------------- | --------------------------------------- | | Create chat channel | Create a chat channel in a ClickUp workspace. | `CLICKUP_CREATE_CHAT_CHANNEL` | | Create direct message channel | Create a direct message channel in ClickUp. | `CLICKUP_CREATE_DIRECT_MESSAGE_CHANNEL` | | Create location chat channel | Create a Channel on a Space, Folder, or List in ClickUp. | `CLICKUP_CREATE_LOCATION_CHAT_CHANNEL` | | Delete chat channel | Delete a chat channel in ClickUp. | `CLICKUP_DELETE_CHAT_CHANNEL` | | Get chat channel | Retrieves details for a specific chat channel in a ClickUp Workspace. | `CLICKUP_GET_CHAT_CHANNEL` | | Get chat channels | Retrieve chat channels in a ClickUp workspace. | `CLICKUP_GET_CHAT_CHANNELS` | | Update chat channel | Update a ClickUp chat channel's properties including name, topic, description, visibility, and location. | `CLICKUP_UPDATE_CHAT_CHANNEL` | | Action | What it does | Slug | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------- | | Create checklist | Creates 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). | `CLICKUP_CREATE_CHECKLIST` | | Delete checklist | Permanently deletes an existing checklist identified by its checklist\_id. | `CLICKUP_DELETE_CHECKLIST` | | Update checklist | Updates an existing checklist's name or position, identified by its checklist\_id. | `CLICKUP_UPDATE_CHECKLIST` | | Action | What it does | Slug | | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- | | Create chat view comment | Posts a new comment to a specified ClickUp Chat view. | `CLICKUP_CREATE_CHAT_VIEW_COMMENT` | | Create list comment | Adds a new comment with specific text to an existing and accessible ClickUp List, assigns it to a user, and sets notification preferences for all list members. | `CLICKUP_CREATE_LIST_COMMENT` | | Create task comment | Adds a comment to a ClickUp task. | `CLICKUP_CREATE_TASK_COMMENT` | | Create threaded comment | Create a threaded reply to a comment in ClickUp. | `CLICKUP_CREATE_THREADED_COMMENT` | | Delete comment | Deletes an existing comment from a task using its comment\_id. | `CLICKUP_DELETE_COMMENT` | | Get chat view comments | Retrieves 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. | `CLICKUP_GET_CHAT_VIEW_COMMENTS` | | Get list comments | Retrieves comments for a specific ClickUp List, supporting pagination using start (timestamp) and start\_id (comment ID) to fetch earlier comments. | `CLICKUP_GET_LIST_COMMENTS` | | Get task comments | Retrieves up to 25 comments for a specified task, supporting pagination using start and start\_id to fetch older comments. | `CLICKUP_GET_TASK_COMMENTS` | | Get threaded comments | Retrieves threaded replies to a parent comment. | `CLICKUP_GET_THREADED_COMMENTS` | | Update comment | Updates an existing task comment's text, assignee (who must be a valid workspace member), or resolution status, requiring a valid existing comment\_id. | `CLICKUP_UPDATE_COMMENT` | | Action | What it does | Slug | | -------------------- | ----------------------------------------------------------------------------------------------------------- | ------------------------------ | | Get doc content | Fetch the full content of a ClickUp Doc including metadata and all page contents in markdown format. | `CLICKUP_GET_DOC_CONTENT` | | Get doc page content | Fetch a single ClickUp Doc page's content and metadata by workspace\_id + doc\_id + page\_id (v3 Docs API). | `CLICKUP_GET_DOC_PAGE_CONTENT` | | Action | What it does | Slug | | ---------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------- | | Get accessible custom fields | Retrieves all accessible Custom Field definitions for a specified ClickUp List using its list\_id. | `CLICKUP_GET_ACCESSIBLE_CUSTOM_FIELDS` | | Remove custom field value | Removes an existing value from a Custom Field on a specific task. | `CLICKUP_REMOVE_CUSTOM_FIELD_VALUE` | | Set custom field value | Sets or updates a Custom Field's value for a task. | `CLICKUP_SET_CUSTOM_FIELD_VALUE` | | Action | What it does | Slug | | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- | | Add dependency | Adds 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. | `CLICKUP_ADD_DEPENDENCY` | | Delete dependency | Removes a dependency relationship for a task. | `CLICKUP_DELETE_DEPENDENCY` | | Action | What it does | Slug | | ----------- | ----------------------------------------------------------------------------------------------------------------------- | --------------------- | | Create doc | Create a new ClickUp Doc in a Workspace (v3 Docs API) and return the new doc\_id for follow-up page/content operations. | `CLICKUP_CREATE_DOC` | | Search docs | Search and list Docs metadata in a ClickUp workspace. | `CLICKUP_SEARCH_DOCS` | | Action | What it does | Slug | | --------------------------- | -------------------------------------------------------------------------------------------- | ------------------------------------- | | Get folder available fields | View custom fields available in a ClickUp folder. | `CLICKUP_GET_FOLDER_AVAILABLE_FIELDS` | | Get space available fields | Retrieves all custom fields available in a ClickUp Space, identified by space\_id. | `CLICKUP_GET_SPACE_AVAILABLE_FIELDS` | | Get team available fields | Retrieves all custom fields available in a ClickUp Workspace (Team), identified by team\_id. | `CLICKUP_GET_TEAM_AVAILABLE_FIELDS` | | Action | What it does | Slug | | --------------------------------------------- | -------------------------------------------------------------------- | ------------------------------------------------------- | | Attachments upload file to task as attachment | DEPRECATED: Use create\_task\_attachment to upload a file to a task. | `CLICKUP_ATTACHMENTS_UPLOAD_FILE_TO_TASK_AS_ATTACHMENT` | | Action | What it does | Slug | | ------------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------- | | Create folder | Creates a new ClickUp Folder within the specified Space, which must exist and be accessible. | `CLICKUP_CREATE_FOLDER` | | Delete folder | Permanently and irreversibly deletes a specified folder and all its contents (Lists, Tasks) if the folder\_id exists. | `CLICKUP_DELETE_FOLDER` | | Get folder | Retrieves detailed information about a specific folder in ClickUp. | `CLICKUP_GET_FOLDER` | | Get folders | Retrieves Folders within a specified ClickUp Space, ensuring space\_id is valid, with an option to filter by archived status. | `CLICKUP_GET_FOLDERS` | | Update folder | Updates the name of an existing folder in ClickUp. | `CLICKUP_UPDATE_FOLDER` | | Action | What it does | Slug | | -------------------------- | --------------------------------------------- | ------------------------------------ | | Get chat channel followers | Retrieve followers of a ClickUp chat channel. | `CLICKUP_GET_CHAT_CHANNEL_FOLLOWERS` | | Action | What it does | Slug | | ----------- | ---------------------------------------------------------------------------------------------- | --------------------- | | Create goal | Creates a new goal in a ClickUp Team (Workspace). | `CLICKUP_CREATE_GOAL` | | Delete goal | Permanently removes an existing Goal, identified by its goal\_id, from the Workspace. | `CLICKUP_DELETE_GOAL` | | Get goal | Retrieves detailed information for an existing ClickUp Goal, specified by its unique goal\_id. | `CLICKUP_GET_GOAL` | | Get goals | Retrieves goals for a specified ClickUp Workspace (Team). | `CLICKUP_GET_GOALS` | | Update goal | Updates attributes of an existing ClickUp goal, identified by its goal\_id. | `CLICKUP_UPDATE_GOAL` | | Action | What it does | Slug | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------- | | Add guest to folder | Adds a guest to a folder with specified permissions. | `CLICKUP_ADD_GUEST_TO_FOLDER` | | Add guest to list | Shares a ClickUp List with an existing guest user, granting them specified permissions. | `CLICKUP_ADD_GUEST_TO_LIST` | | Add guest to task | Assigns a guest to a task with specified permissions. | `CLICKUP_ADD_GUEST_TO_TASK` | | Get guest | Retrieve detailed information for a specific guest within a Team (Workspace), ensuring the guest\_id is valid for the given team\_id. | `CLICKUP_GET_GUEST` | | Invite guest to workspace | Invites a guest by email to a ClickUp Workspace (Team) on an Enterprise Plan, setting initial permissions and optionally a custom role. | `CLICKUP_INVITE_GUEST_TO_WORKSPACE` | | Remove guest from folder | Revokes a guest's access to a specific ClickUp Folder, optionally unsharing items explicitly shared with them within it. | `CLICKUP_REMOVE_GUEST_FROM_FOLDER` | | Remove guest from list | Revokes a guest's access to a specific List, provided the guest currently has access to this List and the Workspace is on the ClickUp Enterprise Plan. | `CLICKUP_REMOVE_GUEST_FROM_LIST` | | Remove guest from task | Revokes a guest's access to a specific task. | `CLICKUP_REMOVE_GUEST_FROM_TASK` | | Remove guest from workspace | Permanently removes a guest from a specified Workspace, revoking all their access. | `CLICKUP_REMOVE_GUEST_FROM_WORKSPACE` | | Update guest on workspace | Modifies the details and permissions of an existing guest user within a specific Workspace. | `CLICKUP_UPDATE_GUEST_ON_WORKSPACE` | | Action | What it does | Slug | | ---------------------- | --------------------------------------------------------------------------------------------------------- | -------------------------------- | | Get time entry history | Retrieves the modification history for an existing time entry within a specific ClickUp Team (Workspace). | `CLICKUP_GET_TIME_ENTRY_HISTORY` | | Action | What it does | Slug | | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- | | Create checklist item | Creates a new checklist item within a specified, existing checklist, optionally setting the item's name and assigning it to a user. | `CLICKUP_CREATE_CHECKLIST_ITEM` | | Delete checklist item | Permanently deletes an existing item, identified by checklist\_item\_id, from an existing checklist, identified by checklist\_id. | `CLICKUP_DELETE_CHECKLIST_ITEM` | | Update checklist item | Updates an existing checklist item, allowing modification of its name, assignee, resolution status, or parent item for nesting. | `CLICKUP_UPDATE_CHECKLIST_ITEM` | | Action | What it does | Slug | | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- | | Create key result | Creates a new Key Result (Target) for a specified Goal in ClickUp to define and track measurable objectives towards achieving that Goal. | `CLICKUP_CREATE_KEY_RESULT` | | Delete key result | Deletes an existing Key Result, also referred to as a Target within a Goal, identified by its key\_result\_id. | `CLICKUP_DELETE_KEY_RESULT` | | Update key result | Updates an existing key result's progress or note in ClickUp, where the key result measures progress towards a goal. | `CLICKUP_UPDATE_KEY_RESULT` | | Action | What it does | Slug | | ---------------- | -------------------------------------------------------------------------------------------------------- | -------------------------- | | Add task link | Links two existing and accessible ClickUp tasks, identified by task\_id (source) and links\_to (target). | `CLICKUP_ADD_TASK_LINK` | | Delete task link | Deletes an existing link, effectively a dependency or relationship, between two ClickUp tasks. | `CLICKUP_DELETE_TASK_LINK` | | Action | What it does | Slug | | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- | | Authorization get work space list | DEPRECATED: Use get\_authorized\_teams\_workspaces instead to retrieve Workspaces (Teams) accessible to the authenticated user. | `CLICKUP_AUTHORIZATION_GET_WORK_SPACE_LIST` | | Create folderless list | Creates a new folderless list (a list not part of any Folder) directly within a specified ClickUp Space. | `CLICKUP_CREATE_FOLDERLESS_LIST` | | Create list | Creates a new list in ClickUp within an existing folder. | `CLICKUP_CREATE_LIST` | | Create list from template | Creates a new list from a template in a specified ClickUp folder. | `CLICKUP_CREATE_LIST_FROM_TEMPLATE` | | Delete list | Permanently deletes an existing List and all its contents. | `CLICKUP_DELETE_LIST` | | Get folderless lists | Retrieves all Lists within a specified Space that are not located in any Folder. | `CLICKUP_GET_FOLDERLESS_LISTS` | | Get list | Retrieves detailed information for an existing List in ClickUp, identified by its unique list\_id. | `CLICKUP_GET_LIST` | | Get lists | Retrieves all lists within a specified, existing ClickUp folder, optionally filtering by archived status. | `CLICKUP_GET_LISTS` | | Update list | Updates attributes of an existing ClickUp list, such as its name, content, due date, priority, assignee, or color status, identified by its list\_id. | `CLICKUP_UPDATE_LIST` | | Action | What it does | Slug | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- | | Get chat channel members | Get members of a chat channel. | `CLICKUP_GET_CHAT_CHANNEL_MEMBERS` | | Get list members | Retrieves all members of a specific, existing ClickUp List by its ID. | `CLICKUP_GET_LIST_MEMBERS` | | Get task members | Retrieves users with explicit access (directly assigned or shared) to a specific existing task, excluding users with inherited permissions. | `CLICKUP_GET_TASK_MEMBERS` | | Action | What it does | Slug | | -------------------- | ------------------------------------------------------------------------------------- | ------------------------------ | | Create chat message | Send a message in a ClickUp chat channel. | `CLICKUP_CREATE_CHAT_MESSAGE` | | Create reply message | Create a reply to a chat message in ClickUp. | `CLICKUP_CREATE_REPLY_MESSAGE` | | Delete chat message | Delete a chat message in ClickUp. | `CLICKUP_DELETE_CHAT_MESSAGE` | | Get chat messages | Retrieve messages from a ClickUp chat channel. | `CLICKUP_GET_CHAT_MESSAGES` | | Update chat message | Update a ClickUp chat message's content, assignee, or resolved status via the v3 API. | `CLICKUP_UPDATE_CHAT_MESSAGE` | | Action | What it does | Slug | | ------------------------ | ------------------------------------------------------------------------------- | ---------------------------------- | | Click up update doc page | Update/edit a ClickUp Doc page's title and/or content via the v3 Docs API. | `CLICKUP_CLICK_UP_UPDATE_DOC_PAGE` | | Create doc page | Create a page in a ClickUp Doc (v3 Docs API). | `CLICKUP_CREATE_DOC_PAGE` | | Get doc page listing | Fetch the page listing structure of a ClickUp Doc by workspace\_id and doc\_id. | `CLICKUP_GET_DOC_PAGE_LISTING` | | Get doc pages public | Fetch pages belonging to a ClickUp Doc. | `CLICKUP_GET_DOC_PAGES_PUBLIC` | | Action | What it does | Slug | | ------------------ | ----------------------------------------------------------------------------------------- | ---------------------------- | | Get workspace plan | Retrieves the details of the current subscription plan for a specified ClickUp Workspace. | `CLICKUP_GET_WORKSPACE_PLAN` | | Action | What it does | Slug | | -------------------------- | ------------------------------------------------- | ------------------------------------ | | Create chat reaction | Add a reaction to a ClickUp chat message. | `CLICKUP_CREATE_CHAT_REACTION` | | Delete chat reaction | Delete a reaction from a chat message in ClickUp. | `CLICKUP_DELETE_CHAT_REACTION` | | Get chat message reactions | Retrieve reactions on a ClickUp chat message. | `CLICKUP_GET_CHAT_MESSAGE_REACTIONS` | | Action | What it does | Slug | | ------------------------ | ----------------------------------------------- | ---------------------------------- | | Get chat message replies | Retrieves replies to a chat message in ClickUp. | `CLICKUP_GET_CHAT_MESSAGE_REPLIES` | | Action | What it does | Slug | | ---------------- | ------------------------------------------------------------------------------------------------------------- | -------------------------- | | Get custom roles | Retrieves all Custom Roles, which allow granular permission configurations, for a specified Workspace (Team). | `CLICKUP_GET_CUSTOM_ROLES` | | Action | What it does | Slug | | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | | Create space | Creates a new ClickUp Space within a specified Workspace, allowing feature configuration which defaults to Workspace settings if unspecified. | `CLICKUP_CREATE_SPACE` | | Delete space | Permanently deletes a specified Space in ClickUp. | `CLICKUP_DELETE_SPACE` | | Get space | Retrieves detailed information for an existing Space in a ClickUp Workspace, identified by its unique space\_id. | `CLICKUP_GET_SPACE` | | Get spaces | Retrieves Spaces for a Team ID. | `CLICKUP_GET_SPACES` | | Update space | Updates an existing ClickUp Space, allowing modification of its name, color, privacy, and feature settings (ClickApps). | `CLICKUP_UPDATE_SPACE` | | Action | What it does | Slug | | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | | Add tag to task | Adds an existing tag to a specified task. | `CLICKUP_ADD_TAG_TO_TASK` | | Add tags to time entries | Associates a list of specified tags with one or more time entries within a given Team (Workspace). | `CLICKUP_ADD_TAGS_TO_TIME_ENTRIES` | | Create space tag | Creates a new tag (name, foreground color, background color) in an existing ClickUp Space. | `CLICKUP_CREATE_SPACE_TAG` | | Delete space tag | Deletes a Tag from a Space, identified by tag\_name in path. | `CLICKUP_DELETE_SPACE_TAG` | | Get all tags from time entries | Retrieves all unique tags applied to time entries within a specified ClickUp Team (Workspace). | `CLICKUP_GET_ALL_TAGS_FROM_TIME_ENTRIES` | | Get space tags | Retrieves all tags for tasks within a specified ClickUp Space, requiring a valid space\_id. | `CLICKUP_GET_SPACE_TAGS` | | Remove tag from task | Removes 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. | `CLICKUP_REMOVE_TAG_FROM_TASK` | | Remove tags from time entries | Removes tags from specified time entries in a team, without deleting the tags from the workspace. | `CLICKUP_REMOVE_TAGS_FROM_TIME_ENTRIES` | | Update space tag | Updates an existing tag's name and colors in a ClickUp Space. | `CLICKUP_UPDATE_SPACE_TAG` | | Update time entry tag | Updates the name, background color, and/or foreground color for an existing time entry tag, identified by its current name and team\_id. | `CLICKUP_UPDATE_TIME_ENTRY_TAG` | | Action | What it does | Slug | | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- | | Add task to list | Adds an existing task to an additional ClickUp List. | `CLICKUP_ADD_TASK_TO_LIST` | | Create task | Creates 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. | `CLICKUP_CREATE_TASK` | | Create task from template | Creates a new task in a specified ClickUp list from a task template, using the provided name for the new task. | `CLICKUP_CREATE_TASK_FROM_TEMPLATE` | | Delete task | Permanently deletes a task, using its standard ID or a custom task ID (requires custom\_task\_ids=true and team\_id). | `CLICKUP_DELETE_TASK` | | Get bulk tasks time in status | Retrieves the time spent in each status for multiple tasks. | `CLICKUP_GET_BULK_TASKS_TIME_IN_STATUS` | | Get filtered team tasks | Retrieves a paginated list of tasks (up to 100 per page) from a specified workspace based on various filter criteria, respecting user access permissions. | `CLICKUP_GET_FILTERED_TEAM_TASKS` | | Get task | Retrieves comprehensive details for a ClickUp task by its ID, supporting standard or custom task IDs (requires team\_id for custom IDs). | `CLICKUP_GET_TASK` | | Get task time in status | Retrieves the duration a task has spent in each status, provided the 'Total time in Status' ClickApp is enabled for the Workspace. | `CLICKUP_GET_TASK_TIME_IN_STATUS` | | Get tasks | Retrieves tasks from a specified ClickUp list. | `CLICKUP_GET_TASKS` | | Get view tasks | Retrieves all tasks visible in a specified ClickUp view, respecting its applied filters, sorting, and grouping. | `CLICKUP_GET_VIEW_TASKS` | | Move task to home list | Move a task to a new home List using ClickUp Public API v3. | `CLICKUP_MOVE_TASK_TO_HOME_LIST` | | Remove task from list | Removes a task from an extra list (not its home list). | `CLICKUP_REMOVE_TASK_FROM_LIST` | | Update task | Updates attributes of an existing task. | `CLICKUP_UPDATE_TASK` | | Action | What it does | Slug | | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | | Create team | Creates a new team (user group) with specified members in a Workspace. | `CLICKUP_CREATE_TEAM` | | Delete team | Permanently deletes an existing Team (user group) from the Workspace using its group\_id. | `CLICKUP_DELETE_TEAM` | | Get teams | Retrieves user groups (Teams) from a ClickUp Workspace, typically requiring team\_id (Workspace ID), with an option to filter by group\_ids. | `CLICKUP_GET_TEAMS` | | Update team | Updates an existing ClickUp User Group (Team) using its group\_id. | `CLICKUP_UPDATE_TEAM` | | Action | What it does | Slug | | ------------------ | ------------------------------------------------------------------------------------ | ---------------------------- | | Get task templates | Retrieves task templates for a specified Workspace (Team ID), supporting pagination. | `CLICKUP_GET_TASK_TEMPLATES` | | Action | What it does | Slug | | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | | Create a time entry | Creates a new time entry for a specified team. | `CLICKUP_CREATE_A_TIME_ENTRY` | | Delete time entry | Deletes an existing time entry, specified by timer\_id, from a Workspace identified by team\_id. | `CLICKUP_DELETE_TIME_ENTRY` | | Get running time entry | Retrieves the currently active time entry for a user in a Workspace. | `CLICKUP_GET_RUNNING_TIME_ENTRY` | | Get time entries in date range | Retrieves 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). | `CLICKUP_GET_TIME_ENTRIES_IN_DATE_RANGE` | | Get time entry | Fetches a specific time entry by its ID for a given team. | `CLICKUP_GET_TIME_ENTRY` | | Start time entry | Starts 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). | `CLICKUP_START_TIME_ENTRY` | | Stop time entry | Stops the authenticated user's currently active time entry in the specified Team (Workspace), which requires an existing time entry to be running. | `CLICKUP_STOP_TIME_ENTRY` | | Update time entry | Updates an existing ClickUp time entry. | `CLICKUP_UPDATE_TIME_ENTRY` | | Action | What it does | Slug | | ---------------- | --------------------------------------------------------------------------------------------------- | -------------------------- | | Get access token | Exchanges a ClickUp OAuth 2.0 authorization code (obtained after user consent) for an access token. | `CLICKUP_GET_ACCESS_TOKEN` | | Action | What it does | Slug | | --------------------- | ---------------------------------------------------------------------------------- | ------------------------------- | | Get custom task types | Retrieves all custom task types available within a specified Workspace (team\_id). | `CLICKUP_GET_CUSTOM_TASK_TYPES` | | Action | What it does | Slug | | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- | | Get authorized user | Retrieves the details of the currently authenticated ClickUp user. | `CLICKUP_GET_AUTHORIZED_USER` | | Get chat message tagged users | Retrieve users tagged in a ClickUp chat message. | `CLICKUP_GET_CHAT_MESSAGE_TAGGED_USERS` | | Get user | Retrieves detailed information for a specific user within a ClickUp Workspace (Team), available only for Workspaces on the ClickUp Enterprise Plan. | `CLICKUP_GET_USER` | | Invite user to workspace | Invites a user via email to a ClickUp Workspace (Team), optionally granting admin rights or a custom role. | `CLICKUP_INVITE_USER_TO_WORKSPACE` | | Remove user from workspace | Deactivates a user from a specified ClickUp Workspace, revoking their access (user can be reactivated later). | `CLICKUP_REMOVE_USER_FROM_WORKSPACE` | | Update user on workspace | Updates a user's username, admin status, or custom role in a Workspace. | `CLICKUP_UPDATE_USER_ON_WORKSPACE` | | Action | What it does | Slug | | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ | | Create folder view | Creates a new, highly customizable view within a specific ClickUp folder using its folder\_id. | `CLICKUP_CREATE_FOLDER_VIEW` | | Create list view | Creates a new, customizable view (e.g., list, board, calendar) within a specified ClickUp List, requiring an existing list\_id accessible by the user. | `CLICKUP_CREATE_LIST_VIEW` | | Create space view | Creates a customizable view (e.g., List, Board, Gantt) within a specified ClickUp Space, allowing configuration of grouping, sorting, filtering, and display settings. | `CLICKUP_CREATE_SPACE_VIEW` | | Create workspace everything level view | Creates a new, customizable view (e.g., List, Board) at the 'Everything' level for a specified Team (Workspace ID), encompassing all tasks within that Workspace. | `CLICKUP_CREATE_WORKSPACE_EVERYTHING_LEVEL_VIEW` | | Delete view | Permanently and irreversibly deletes an existing View in ClickUp, identified by its view\_id. | `CLICKUP_DELETE_VIEW` | | Get folder views | Retrieves all configured views (like List, Board, Calendar) for a specified, existing Folder in ClickUp. | `CLICKUP_GET_FOLDER_VIEWS` | | Get list views | Retrieves all task and page views for a specified and accessible ClickUp List. | `CLICKUP_GET_LIST_VIEWS` | | Get space views | Retrieves all task and page views for a specified Space ID in ClickUp. | `CLICKUP_GET_SPACE_VIEWS` | | Get view | Fetches details for a specific ClickUp view, identified by its view\_id, which must exist. | `CLICKUP_GET_VIEW` | | Get workspace everything level views | Retrieves all task and page views at the 'Everything Level' (a comprehensive overview of all tasks across all Spaces) for a specified ClickUp Workspace. | `CLICKUP_GET_WORKSPACE_EVERYTHING_LEVEL_VIEWS` | | Update view | Updates an existing ClickUp view's settings such as name, type, grouping, or filters. | `CLICKUP_UPDATE_VIEW` | | Action | What it does | Slug | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ | | Create webhook | Creates 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. | `CLICKUP_CREATE_WEBHOOK` | | Delete webhook | Permanently removes an existing webhook, specified by its ID, thereby ceasing all its event monitoring and notifications. | `CLICKUP_DELETE_WEBHOOK` | | Get webhooks | Fetches webhooks for a Team (Workspace), returning only those created by the authenticated user via API, for a team\_id they can access. | `CLICKUP_GET_WEBHOOKS` | | Update webhook | Updates the endpoint URL, monitored events, and status of an existing webhook, identified by its webhook\_id. | `CLICKUP_UPDATE_WEBHOOK` | | Action | What it does | Slug | | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | | Get authorized teams workspaces | Retrieves a list of Workspaces (Teams) the authenticated user can access. | `CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES` | | Get workspace seats | Retrieves seat utilization (used, total, available for members/guests) for a ClickUp Workspace (Team) ID, which must be for an existing Workspace. | `CLICKUP_GET_WORKSPACE_SEATS` | | Update workspace ACL | Updates privacy and access control list (ACL) permissions for a workspace object or location. | `CLICKUP_UPDATE_WORKSPACE_ACL` | | Action | What it does | Slug | | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ | | Delete time tracked | Deletes a time-tracked interval from a task. | `CLICKUP_DELETE_TIME_TRACKED` | | Get shared hierarchy | Retrieves the hierarchy of tasks, Lists, and Folders shared with the authenticated user within an existing ClickUp Team (Workspace), identified by its team\_id. | `CLICKUP_GET_SHARED_HIERARCHY` | | Get subtypes | Retrieve post subtype IDs (Announcement, Discussion, Idea, Update) for a ClickUp Workspace. | `CLICKUP_GET_SUBTYPES` | | Get tracked time | Retrieves tracked time for a task using a legacy endpoint. | `CLICKUP_GET_TRACKED_TIME` | | Track time | Records a time entry for a task using ClickUp's legacy time tracking system. | `CLICKUP_TRACK_TIME` | | Update time tracked | Edits a legacy time-tracked interval for a task (identified by task\_id and interval\_id) to update its start/end times and duration. | `CLICKUP_UPDATE_TIME_TRACKED` | ## Connect ClickUp Before you start: * You need a ClickUp account that you can sign in to. * Your Squad subscription must be active. Squad does not connect apps while the subscription is not active. Open **Settings** > **Integrations**. On the **Connected apps** tab, click **+ Add integration**. Find **ClickUp** in the catalog and click it. You can type the name in **Search the catalog…**. Under **Default scope**, keep **Default**. It is the only option. Click **Connect ClickUp**. The ClickUp sign-in page opens in a new tab. Sign in to ClickUp and approve the request. Check that it works: ClickUp shows under **YOUR CONNECTIONS**, with a row for the account and its access level. ## Set access for one agent Every agent can use the account unless you block it. 1. Under **YOUR CONNECTIONS**, open the account menu (⋯) on the ClickUp account. 2. Click **Manage scope**. 3. Under **Per-agent access**, find the agent. 4. Choose **No access** to block the agent. Choose **Default (Default)** to allow it again. 5. Click **Save access**. Changes apply from the agent's next call. An agent with **No access** does not see the account. ## Use more than one ClickUp account Click **+ Account** on the ClickUp card to connect another account. Agents use the primary account unless they are asked to use a specific one. * After you click **+ Account**, follow the connect steps above. * The first account you connect becomes the primary account. It shows **★ PRIMARY**. * To change the primary account, open the account menu (⋯) and click **Make primary**. * To tell accounts apart, open the account menu (⋯) and click **Rename**. ## Reconnect or disconnect Reconnect when the connection has expired, or when you need to change what the account can reach on the ClickUp side: 1. Open the account menu (⋯) and click **Reconnect**. 2. Click **Reauthorize on ClickUp**. 3. Sign in to ClickUp and approve the request. Reconnect signs in to the same account again. It does not add a second connection. Open the account menu (⋯) on the ClickUp account and click **Disconnect**. Agents lose access to that account at once. **Disconnect** acts at once, with no confirmation step. If it was the primary account, another connected ClickUp account becomes primary. ## Costs ClickUp actions do not use Squad credits. Connected apps never use credits. For what does use credits, see [What Squad costs](/docs/costs). ## Troubleshooting An agent says it has no access to ClickUp, or it does not see the account. * Cause: the agent is set to **No access** under **Per-agent access**, or the account is not connected. * Fix: open **Manage scope** and change the agent's row. If the account is missing, connect it again. Connecting or saving fails with "Your subscription isn't active." * Cause: your Squad subscription is not active. * Fix: resubscribe. See [Manage your subscription](/docs/billing). An agent says the ClickUp connection has expired. * Cause: the sign-in for that account is no longer valid. * Fix: use **Reconnect** on the account. ## Common questions You cannot choose a narrower level for ClickUp. You can block single agents with **No access** under **Per-agent access**. Click **+ Account** on the ClickUp card to connect another account. Agents use the primary account unless they are asked to use a specific one. Open the account menu (⋯) on the ClickUp account and click **Disconnect**. Agents lose access to that account at once. ## Related pages Use this when an action you need is not in this app.