ClickUp: Most-used fields
The table below gives information about most-used fields that you can import from ClickUp. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
AttachmentsDimension
A collection of files or content associated with a task or other ClickUp entity.
Progress.percent_completeMetric
The percentage of completion for a task or a progress-related custom field.
Space URLDimension
The URL to access a specific Space within ClickUp.
Task Progress.percent_completeMetric
The percentage of completion for the task.
User NameDimension
The display name of the user.
User TypeDimension
The type or role of the user within ClickUp, such as Owner, Admin, Member, or Guest.
archivedDimension
A boolean indicating whether an entity (e.g., Space, Folder, List, or Task) is archived.
assignees.colorDimension
The color associated with the user profile of an assignee.
assignees.emailDimension
The email address of a user assigned to the task.
assignees.idMetric
The unique identifier of a user assigned to the task.
assignees.initialsDimension
The initials of a user assigned to the task.
assignees.profilePictureDimension
The URL to the profile picture of a user assigned to the task.
assignees.usernameDimension
The username of a user assigned to the task.
attachments.{NUM}.dateMetric
The timestamp indicating when the attachment was created or uploaded.
attachments.{NUM}.deletedDimension
Indicates if the attachment has been marked as deleted.
attachments.{NUM}.email_dataDimension
An object containing metadata specific to email attachments, such as sender, recipient, and subject.
attachments.{NUM}.email_data.clientDimension
The email client or application used to send the email attachment.
attachments.{NUM}.email_data.emailDimension
The primary email address associated with the email attachment (e.g., recipient's email).
attachments.{NUM}.email_data.fromDimension
The sender's email address for the email attachment.
attachments.{NUM}.email_data.idDimension
A unique identifier for the email data within the attachment.
attachments.{NUM}.email_data.msgDimension
The body or content of the email message.
attachments.{NUM}.email_data.subjectDimension
The subject line of the email.
attachments.{NUM}.extensionDimension
The file extension of the attached file (e.g., 'pdf', 'jpg', 'doc').
attachments.{NUM}.hiddenDimension
Indicates if the attachment is hidden from view.
attachments.{NUM}.idDimension
The unique identifier of the attachment.
attachments.{NUM}.is_folderDimension
Indicates if the attached item is a folder instead of a single file.
attachments.{NUM}.mimetypeDimension
The MIME type of the attachment, indicating its file format (e.g., 'image/jpeg', 'application/pdf').
attachments.{NUM}.orientationDimension
The orientation of the attachment, typically for images (e.g., portrait, landscape).
attachments.{NUM}.parent_idDimension
The unique identifier of the parent object (e.g., task, comment) to which this attachment belongs.
attachments.{NUM}.resolved_commentsMetric
The count of resolved comments associated with this attachment.
attachments.{NUM}.sizeMetric
The size of the attachment in bytes.
attachments.{NUM}.sourceMetric
The origin or source of the attachment (e.g., local upload, Google Drive, Dropbox).
attachments.{NUM}.thumbnail_largeDimension
The URL for a larger-sized thumbnail image of the attachment.
attachments.{NUM}.thumbnail_mediumDimension
The URL for a medium-sized thumbnail image of the attachment.
attachments.{NUM}.thumbnail_smallDimension
The URL for a smaller-sized thumbnail image of the attachment.
attachments.{NUM}.titleDimension
The display title or name of the attachment.
attachments.{NUM}.total_commentsMetric
The total number of comments associated with this attachment.
attachments.{NUM}.typeMetric
The classification or category of the attachment (e.g., 'image', 'file', 'email').
attachments.{NUM}.urlDimension
The direct URL to access or download the attachment.
attachments.{NUM}.url_w_hostDimension
The full URL of the attachment, including its host domain.
attachments.{NUM}.url_w_queryDimension
The full URL of the attachment, including any query parameters appended to it.
attachments.{NUM}.user.colorDimension
The hex color code associated with the user who uploaded the attachment.
attachments.{NUM}.user.emailDimension
The email address of the user associated with the attachment.
attachments.{NUM}.user.idMetric
The unique identifier of the user who uploaded the attachment.
attachments.{NUM}.user.initialsDimension
The initials of the user who uploaded the attachment.
attachments.{NUM}.user.profilePictureDimension
The URL of the profile picture for the user who uploaded the attachment.
attachments.{NUM}.user.usernameDimension
The username of the user associated with the attachment.
attachments.{NUM}.versionMetric
The version number of the attachment.
checklists.creatorMetric
Details about the user who created the checklist.
checklists.date_createdMetric
The date and time when the checklist was created within a task. This timestamp indicates when the checklist was first added.
checklists.idDimension
The unique identifier of the checklist.
checklists.itemsDimension
A list of individual items contained within the checklist.
checklists.nameDimension
The name or title of the checklist.
checklists.orderindexMetric
The order index of the checklist, defining its position relative to other checklists or elements.
checklists.resolvedMetric
The number of resolved (completed) items in the checklist.
checklists.task_idDimension
The unique identifier of the task to which the checklist is associated.
checklists.unresolvedMetric
The number of unresolved (pending) items in the checklist.
creator.colorDimension
The color associated with the user profile of the task's creator.
creator.emailDimension
The email address of the user who created the task.
creator.idMetric
The unique identifier of the user who created the task.
creator.profilePictureDimension
The URL to the profile picture of the task's creator.
creator.usernameDimension
The username of the person who created the task.
custom_idDimension
A custom identifier for the task, often used for external system integration. This is an optional field set by the user.
date_closedDimension
The date and time when the task was marked as closed, in Unix time in milliseconds.
date_createdDimension
The date and time when the task or item was created, in Unix time in milliseconds.
date_doneDimension
This field represents the date and time when a task was marked as complete or done.
date_updatedDimension
The date and time when the task or item was last updated, in Unix time in milliseconds.
dependencies.chain_idDimension
A unique identifier for a sequence or chain of related task dependencies.
dependencies.date_createdMetric
The timestamp (in Unix milliseconds) when this specific task dependency was created. [1]
dependencies.depends_onDimension
The unique identifier of the task that must be completed before the current task can proceed.
dependencies.task_idDimension
The unique identifier of the task for which this dependency is defined.
dependencies.typeMetric
The type of relationship between dependent tasks (e.g., 'waiting on', 'blocking', 'linked').
dependencies.useridMetric
The unique identifier of the user who created or last modified this task dependency. [1]
dependencies.workspace_idDimension
The unique identifier of the workspace to which this dependency belongs.
descriptionDimension
A detailed description of the task or item.
due_dateDimension
The date and time when the task is due, in Unix time in milliseconds.
folder.accessDimension
A boolean indicating if the current user has access to the folder.
folder.hiddenDimension
A boolean indicating if the folder is hidden from view.
folder.idMetric
The unique identifier of the folder.
folder.nameDimension
The name of the folder.
idDimension
The unique identifier of the task or item.
linked_tasks.date_createdMetric
The date and time when a task link relationship was established between two tasks. This indicates when one task was linked to another.
linked_tasks.link_idDimension
The unique identifier for the task link or relationship.
linked_tasks.task_idDimension
The unique identifier of the linked task.
linked_tasks.useridMetric
The unique identifier of the user who created the task link.
linked_tasks.workspace_idDimension
The unique identifier of the workspace to which the linked task belongs.
list.accessDimension
A boolean indicating if the current user has access to the list.
list.idMetric
The unique identifier of the list containing the task.
list.nameDimension
The name of the list containing the task.
locations.{NUM}.idMetric
This field represents the unique identifier for a specific hierarchical location within ClickUp, such as a Space, Folder, or List.
locations.{NUM}.nameDimension
This field provides the name of a specific hierarchical location within ClickUp, such as a Space, Folder, or List.
nameDimension
The name or title of the task or item.
orderindexMetric
The numerical index used to determine the order of the item within its parent (e.g., task within a list, list within a folder).
parentDimension
The unique identifier of the parent task, if the current item is a subtask.
permission_levelDimension
The permission level of the current user for the item.
pointsMetric
The number of points assigned to the task, used to quantify task size or effort.
priorityDimension
The priority level of the task.
priority.colorDimension
The color associated with the task's priority level.
priority.idMetric
The unique identifier of the task's priority level.
priority.orderindexMetric
The numerical index used to determine the order of the task's priority.
priority.priorityDimension
The name of the task's priority level (e.g., 'Urgent', 'High', 'Normal', 'Low').
project.idMetric
The unique identifier for a project in ClickUp, which corresponds to a Space, Folder, or List.
project.nameDimension
The name of the project, which corresponds to a Space, Folder, or List in ClickUp.
sharing.permission_levelMetric
The overall permission level for sharing the entity (e.g., 'public', 'private', 'read-only').
sharing.permissions.can_commentDimension
A boolean indicating if commenting is allowed for the specific permission.
sharing.permissions.nameDimension
The name of the specific permission applied (e.g., 'View', 'Edit', 'Comment').
spaceDimension
The name or object representing the Space where the item is located.
space.idMetric
The unique identifier of the Space where the item is located.
start_dateDimension
The date and time when the task is scheduled to start, in Unix time in milliseconds.
status.colorDimension
The color associated with the task's status.
status.idDimension
The unique identifier of the status associated with a task or list.
status.orderindexMetric
The numerical index used to determine the order of the task's status within its workflow.
status.statusDimension
The name of the task's status (e.g., 'Open', 'In Progress', 'Complete').
status.typeDimension
The type of the task's status (e.g., 'open', 'closed', 'custom').
tags.nameDimension
The name of a tag associated with the task.
teamDimension
The name or object representing the Team (Workspace) where the item is located.
team_idDimension
The unique identifier of the Team (Workspace) where the item is located.
text_contentDimension
The plain text content of the task's description or other text fields.
time_estimateDimension
The estimated time required to complete the task, in milliseconds.
time_estimates_by_user.{NUM}.time_estimateMetric
This field represents the estimated amount of time allocated for a task by a specific user or assignee.
time_estimates_by_user.{NUM}.user.colorDimension
The color associated with the user who provided the time estimate.
time_estimates_by_user.{NUM}.user.emailDimension
The email address of the user who provided the time estimate.
time_estimates_by_user.{NUM}.user.idMetric
The unique identifier of the user who provided the time estimate.
time_estimates_by_user.{NUM}.user.initialsDimension
The initials of the user who provided the time estimate.
time_estimates_by_user.{NUM}.user.profilePictureDimension
The URL to the profile picture of the user who provided the time estimate, if available.
time_estimates_by_user.{NUM}.user.usernameDimension
The username of the user who provided the time estimate.
time_spentMetric
The total time spent on the task, in milliseconds. This field is only included for tasks with time entries.
urlDimension
The URL to access the task or item in ClickUp.
watchers.colorDimension
The color associated with the watcher.
watchers.emailDimension
The email address of the watcher.
watchers.idMetric
The unique identifier of the watcher.
watchers.initialsDimension
The initials of the watcher.
watchers.profilePictureDimension
The URL to the profile picture of the watcher, if available.
watchers.usernameDimension
The username of the watcher.