ClickUp Lookup icon

ClickUp Lookup

Resolve ClickUp dropdown, label, status, and priority options — map names to IDs without hard-coding metadata

Actions6

Task → Get

AI-generated

Overview

This node operation retrieves a specific task from ClickUp by its task ID. It supports using either the internal ClickUp task ID or a custom human-readable task ID, which requires specifying the associated Team (Workspace). This operation is useful for fetching detailed information about a particular task, such as its status, priority, custom fields, and other metadata, enabling automation workflows that need to access or process task data directly.

Use Case Examples

  1. Fetch a task by its internal ClickUp ID to update or analyze its details in an automation workflow.
  2. Retrieve a task using a custom task ID within a specified team to integrate ClickUp task data with other systems or reports.

Properties

Name Meaning
Authentication Select the authentication method to use for API requests (Access Token or OAuth2).
Team (Workspace) Name or ID Specify the team or workspace ID or name when using a custom task ID to identify the correct context for the task.
Use Custom Task ID Boolean flag indicating whether the provided Task ID is a custom human-readable ID instead of the internal ClickUp ID.
Task ID The ID of the task to retrieve. This can be the internal ClickUp task ID or a custom task ID if 'Use Custom Task ID' is enabled.

Output

JSON

  • id - The unique identifier of the retrieved task.
  • name - The name or title of the task.
  • status - The current status of the task.
  • priority - The priority level assigned to the task.
  • custom_fields - Custom fields associated with the task, if any.
  • assignees - List of users assigned to the task.
  • due_date - The due date of the task, if set.
  • description - Detailed description or notes of the task.

Dependencies

  • ClickUp API access with either an access token or OAuth2 credentials.

Troubleshooting

  • If 'Use Custom Task ID' is enabled but no Team (Workspace) is specified, the node throws an error indicating that the team is required.
  • If the Task ID is invalid or the task does not exist, the API request will fail, resulting in an error.
  • Ensure that the authentication credentials are valid and have sufficient permissions to access the task data.

Discussion