Task → List
AI-generatedOverview
This node operation lists tasks from a specified ClickUp list. It supports different methods to select the list, including browsing by team, space, and folder hierarchy, or directly specifying a list ID. Users can filter tasks by status, include closed tasks, and include subtasks. This operation is useful for workflows that need to retrieve and process tasks from ClickUp dynamically based on various selection criteria.
Use Case Examples
- Retrieve all tasks from a specific ClickUp list by providing the list ID.
- Browse through a team and space hierarchy to select a list and fetch its tasks.
- Filter tasks to include only those with specific statuses or include subtasks for detailed task management.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating with ClickUp API, either Access Token or OAuth2. |
| List Selection | Method to select the ClickUp list to fetch tasks from, either by browsing hierarchy, classic folder hierarchy, or directly by list ID. |
| List ID | The ClickUp list ID to fetch tasks from, required if List Selection is 'List ID'. |
| Team (Workspace) Name or ID | The team (workspace) identifier to browse lists when using browse or hierarchy selection modes. |
| Space Name or ID | The space identifier within the team to browse lists when using browse or hierarchy selection modes. |
| Folder Name or ID | The folder identifier within the space to browse lists when using hierarchy selection mode and folderless is false. |
| Folderless List | Boolean to indicate if the list is folderless when using hierarchy selection mode. |
| List Name or ID | The list identifier to fetch tasks from when browsing or using hierarchy selection modes. |
| Include Closed Tasks | Boolean to specify whether to include tasks in closed statuses. |
| Include Subtasks | Boolean to specify whether to include subtasks from the list. |
| Status Names or IDs | Filter tasks by specific status names or IDs. |
| Limit | Maximum number of tasks to return. |
Output
JSON
id- The unique identifier of the task.name- The name or title of the task.status- The current status of the task.priority- The priority level of the task.due_date- The due date of the task.assignees- List of users assigned to the task.subtasks- List of subtasks if included.
Dependencies
- ClickUp API
Troubleshooting
- Ensure the correct list ID or browse parameters are provided; missing or incorrect IDs will cause errors.
- If using custom task IDs, the Team (Workspace) parameter must be specified to avoid errors.
- When filtering tasks, ensure that either a search value is provided or 'List All Tasks' is enabled; otherwise, the node will throw an error.
- Authentication errors may occur if the access token or OAuth2 credentials are invalid or expired; verify credentials in node settings.