Field → Resolve Option
AI-generatedOverview
The ClickUp Lookup node with the Field resource and Resolve Option operation is designed to resolve and map ClickUp dropdown, label, status, and priority options. It allows users to map names to IDs dynamically without hard-coding metadata, which is useful for workflows that need to interact with ClickUp custom fields and options reliably. For example, it can be used to translate user-friendly names of custom field options into their corresponding IDs for task updates or filtering.
Use Case Examples
- Mapping a custom field option name to its ID to update a task in ClickUp.
- Resolving the status name to its ID to filter tasks by status.
- Converting priority names to their IDs for task prioritization workflows.
Properties
| Name | Meaning |
|---|---|
| authentication | Method of authentication to use with ClickUp API (Access Token or OAuth2). |
| listSelectionMode | Method to select the ClickUp list (Browse, Hierarchy, or List ID). |
| listId | The ClickUp list ID, required if List ID mode is selected. |
| team | Team (Workspace) Name or ID, required for Browse or Hierarchy modes. |
| space | Space Name or ID within the selected team, required for Browse or Hierarchy modes. |
| folderless | Boolean indicating if the list is folderless, used in Hierarchy mode. |
| folder | Folder Name or ID, required if folderless is false in Hierarchy mode. |
| list | List Name or ID, required in Browse or Hierarchy modes depending on folderless setting. |
| customFieldsUi | Mappings to run against the selected list, allowing one or more option mappings for custom fields, priority, or status. Each mapping defines the target type, field key, value to lookup, and mapping presets or advanced mapping options. |
Output
JSON
error- Error message if the operation fails for an item.
- Resolved mapping results for each configured mapping, including IDs or names as per mapping presets.
Dependencies
- ClickUp API
Troubleshooting
- Ensure the correct list ID or selection mode is used to avoid errors resolving fields.
- Add at least one mapping row under Mappings to avoid operation errors.
- When using custom task IDs, ensure the Team (Workspace) parameter is provided.
- If no search value is provided for task find operations, enable List All Tasks or use '*' to return all tasks.
Links
- ClickUp API Documentation - Official API documentation for ClickUp, useful for understanding available endpoints and data structures.