ClickUp v2

Provides integration with ClickUp to query and maintain ClickUp resources through templates based on its published API v2 schema. Use it to synchronize tasks and project data with other applications.

ClickUp is a work management platform for tasks, projects, documents, and collaboration within Workspaces.

Revision History

0.0.0.6 - Initial release.

Connection

Choose personal-token or OAuth authentication.

Property Type Description
Authentication Enum Select Personal Token (default) or OAuth.
Personal Token Masked Personal API token beginning with pk_; used in Personal Token mode.
Client ID String ClickUp app client identifier; used in OAuth mode.
Client Secret Masked ClickUp app client secret; used in OAuth mode.
Access Token Masked Token obtained through OAuth account authorization.
Timeout (seconds) Integer Maximum time for one API request. Defaults to 30; must be greater than zero.
OpenAPI Schema String Hidden cached schema populated by Acquire Metadata.

Setup Notes

  • Run this Node on a Cloud Runtime.
  • Select the authentication mode and enter the corresponding credentials. For OAuth, register the Flowgear callback URL with your ClickUp app and complete account authorization.
  • Run the Connection test, then select Acquire Metadata before loading operation templates. Refresh metadata when you need an updated operation list.
  • The connected account needs access to the relevant Workspace and resources.

Methods

Select an operation template under the method matching its HTTP verb.

Query

Retrieves ClickUp resources.

Parameter Type Description
Connection Connection Connection used to authenticate the selected operation.
OperationId String Operation identifier populated by the selected template. Select a template instead of entering this manually.
Options Object Documented path and query values for the selected operation.
Return Type Description
Response Array Provider-shaped business rows without a Flowgear object. Collection queries with no matches return zero rows.

Create

Creates resources or executes a POST operation.

Parameter Type Description
Connection Connection Connection used to authenticate the selected operation.
OperationId String Operation identifier populated by the selected template. Select a template instead of entering this manually.
Options Object Documented path and query values for the selected operation.
Items Array JSON request-body objects. Supply at least one item when the operation requires a body; omit Items when no body is documented.
Return Type Description
Response Array Provider response fields with Flowgear.IsSuccess, Flowgear.Message, and Flowgear.Request for each processed request.

Update

Updates resources using a PUT operation.

Parameter Type Description
Connection Connection Connection used to authenticate the selected operation.
OperationId String Operation identifier populated by the selected template. Select a template instead of entering this manually.
Options Object Documented path and query values for the selected operation.
Items Array JSON request-body objects. Supply at least one item when the operation requires a body; omit Items when no body is documented.
Return Type Description
Response Array Provider response fields with Flowgear.IsSuccess, Flowgear.Message, and Flowgear.Request for each processed request.

Patch

Applies changes using a PATCH operation.

Parameter Type Description
Connection Connection Connection used to authenticate the selected operation.
OperationId String Operation identifier populated by the selected template. Select a template instead of entering this manually.
Options Object Documented path and query values for the selected operation.
Items Array JSON request-body objects. Supply at least one item when the operation requires a body; omit Items when no body is documented.
Return Type Description
Response Array Provider response fields with Flowgear.IsSuccess, Flowgear.Message, and Flowgear.Request for each processed request.

Delete

Deletes the resource identified by the selected operation.

Parameter Type Description
Connection Connection Connection used to authenticate the selected operation.
OperationId String Operation identifier populated by the selected template. Select a template instead of entering this manually.
Options Object Documented path and query values for the selected operation.
Return Type Description
Response Array Provider response fields with Flowgear.IsSuccess, Flowgear.Message, and Flowgear.Request for each processed request.

Usage Notes

  • Task-list operations page automatically in 100-item pages. Other endpoints can expose their documented cursor controls in Options.
  • The first provider read or mutation runs before output streaming begins. Query failures surface to the Workflow; handled mutation failures return failed Flowgear metadata.
  • Personal tokens are sent directly in the Authorization header. OAuth access tokens use the Bearer scheme.

Known Issues

  • Multipart attachment operations are not exposed.
  • Operation availability depends on the published schema, ClickUp plan, and Workspace permissions.