> For the complete documentation index, see [llms.txt](https://docs.n8n.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.n8n.io/integrations/builtin/app-nodes/n8n-nodes-base.clickup.md).

# ClickUp

Use the ClickUp node to automate work in ClickUp, and integrate ClickUp with other applications. n8n has built-in support for a wide range of ClickUp features, including creating, getting, deleting, and updating folders, checklists, tags, comments, and goals.

On this page, you'll find a list of operations the ClickUp node supports and links to more resources.

{% hint style="info" %}
**Credentials**

Refer to [ClickUp credentials](/integrations/builtin/credentials/clickup.md) for guidance on setting up authentication.
{% endhint %}

{% hint style="info" %}
**This node can be used as an AI tool**

This node can be used to enhance the capabilities of an AI agent. When used in this way, many parameters can be set automatically, or with information directed by AI - find out more in the [AI tool parameters documentation](/build/integrate-ai/ai-examples/use-ai-for-parameters.md).
{% endhint %}

## Operations <a href="#operations" id="operations"></a>

* Checklist
  * Create a checklist
  * Delete a checklist
  * Update a checklist
* Checklist Item
  * Create a checklist item
  * Delete a checklist item
  * Update a checklist item
* Comment
  * Create a comment
  * Delete a comment
  * Get all comments
  * Update a comment
* Folder
  * Create a folder
  * Delete a folder
  * Get a folder
  * Get all folders
  * Update a folder
* Goal
  * Create a goal
  * Delete a goal
  * Get a goal
  * Get all goals
  * Update a goal
* Goal Key Result
  * Create a key result
  * Delete a key result
  * Update a key result
* List
  * Create a list
  * Retrieve list's custom fields
  * Delete a list
  * Get a list
  * Get all lists
  * Get list members
  * Update a list
* Space Tag
  * Create a space tag
  * Delete a space tag
  * Get all space tags
  * Update a space tag
* Task
  * Create a task
  * Delete a task
  * Get a task
  * Get all tasks
  * Get task members
  * Set a custom field
  * Update a task
* Task List
  * Add a task to a list
  * Remove a task from a list
* Task Tag
  * Add a tag to a task
  * Remove a tag from a task
* Task Dependency
  * Create a task dependency
  * Delete a task dependency
* Time Entry
  * Create a time entry
  * Delete a time entry
  * Get a time entry
  * Get all time entries
  * Start a time entry
  * Stop the current running timer
  * Update a time Entry
* Time Entry Tag
  * Add tag to time entry
  * Get all time entry tags
  * Remove tag from time entry

## Operation details <a href="#operation-details" id="operation-details"></a>

### Get a task <a href="#get-a-task" id="get-a-task"></a>

When using the **Get a task** operation, you can optionally enable the following:

* **Include Subtasks**: When enabled, also fetches and includes subtasks for the specified task.
* **Include Markdown Description**: When enabled, includes the `markdown_description` field in the response, which preserves links and formatting in the task description. This is useful if your task descriptions contain links or rich formatting.

## Templates and examples <a href="#templates-and-examples" id="templates-and-examples"></a>

[Browse ClickUp node documentation integration templates](https://n8n.io/integrations/clickup) or [search all templates](https://n8n.io/workflows/)

If this node doesn't support the operation you want to do, you can use the [HTTP Request node](/integrations/builtin/core-nodes/n8n-nodes-base.httprequest.md) to call the service's API.

You can use the credential you created for this service in the HTTP Request node:

1. In the HTTP Request node, select **Authentication** > **Predefined Credential Type**.
2. Select the service you want to connect to.
3. Select your credential.

Refer to [Custom API operations](/integrations/builtin/custom-api-actions-for-existing-nodes.md) for more information.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.n8n.io/integrations/builtin/app-nodes/n8n-nodes-base.clickup.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
