ClickupLookup icon

ClickupLookup

Map ClickUp custom fields to values

Actions3

Overview

This node enables updating a task in ClickUp by assigning it a custom task type. It is particularly useful when you want to programmatically change the classification or category of a task based on your custom-defined task types within a specific team.

Common scenarios include:

  • Automating workflow steps where tasks need to be reclassified as they progress.
  • Integrating with other systems that determine task types dynamically.
  • Bulk updating tasks to a new custom type based on external triggers.

For example, if you have a "Bug" and "Feature" custom task type in your ClickUp workspace, this node can update a given task's type to "Feature" automatically when certain conditions are met.

Properties

Name Meaning
Authentication Method of authentication to use: either "Access Token" or "OAuth2".
Team Name or ID The team within ClickUp where the task resides. You can select from a list or specify an ID directly. This determines the scope for available task types.
Task ID The unique identifier of the task you want to update.
Task Type Name or ID The custom task type to assign to the task. Choose from the list of available custom task types for the selected team or specify an ID directly.

Output

The node outputs JSON data representing the updated task object returned from the ClickUp API after the update operation. This typically includes fields such as the task ID, updated custom item (task type) ID, and other task metadata reflecting the new state.

No binary data output is produced by this node.

Dependencies

  • Requires access to the ClickUp API.
  • Needs an API authentication credential configured in n8n, either via an Access Token or OAuth2.
  • The node dynamically loads options like teams and task types by making API calls to ClickUp endpoints.
  • Proper permissions on the ClickUp account to read teams and update tasks are necessary.

Troubleshooting

  • Invalid Task ID: If the provided Task ID does not exist or is incorrect, the API will return an error. Verify the Task ID is correct and belongs to the specified team.
  • Insufficient Permissions: Errors may occur if the API token lacks permission to update tasks or access the specified team. Ensure the API credentials have appropriate scopes.
  • Task Type Not Found: Selecting a task type that does not belong to the chosen team or specifying an invalid ID will cause failures. Use the dynamic dropdown to pick valid task types or verify IDs carefully.
  • Network or API Errors: Temporary network issues or ClickUp API downtime can cause request failures. Retry after some time or check ClickUp status.
  • Authentication Issues: Using expired or invalid tokens will result in authentication errors. Refresh or regenerate tokens as needed.

Links and References

Discussion