> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ClickUp

> ClickUp helps teams manage tasks, docs, goals, chat, and time tracking via your connected account.

Use ClickUp when your workflow needs tasks, docs, goals, chat, or time tracking. You can create, read, and update work items across a workspace.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Label for the step in the workflow canvas. |
| Authentication | Yes | The connected ClickUp account to use for this step. |
| Action | Yes | The ClickUp action to perform (for example Get authorized user, List spaces, List folders, List lists). |
| Arguments | Yes | Per-action form fields generated from the action's schema. Each text field has an **Insert Variable** button for injecting `{{placeholder}}` values. A **Raw JSON** tab is available for advanced usage. |
| When the step fails | No | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails. |

Before you configure this step, connect ClickUp in **Integrations** for your workspace using the sign-in flow. If no active connection is available, the step shows a warning with a link to **Integrations** instead of the account selector.

## Arguments form

When you select an action, the **Arguments** section renders a form driven by the action's input schema. Fields that refer to existing records include dropdown pickers.

Switch to the **Raw JSON** tab when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

## Common actions

| Action | Description |
| - | - |
| **Get authorized user** | Fetch the connected ClickUp user profile. |
| **List spaces** | List the Spaces available in a workspace. |
| **List folders** | List folders in a Space. |
| **List lists** | List lists in a folder. |
| **List tasks** | List tasks in a list. |
| **Get task** | Fetch full details for a task. |
| **Create task** | Create a new task in a list. |
| **Update task** | Update fields on an existing task. |
| **Create task comment** | Add a comment to a task. |
| **List task comments** | List comments on a task. |
| **Create doc** | Create a new ClickUp Doc in a workspace. |
| **Get doc content** | Fetch the full content of a doc. |
| **Create doc page** | Add a page to an existing doc. |
| **List doc pages** | List the pages in a doc. |
| **Create goal** | Create a new goal in a workspace. |

Destructive actions, such as deleting records, are not available in the workflow action picker.

## Output

This step stores the ClickUp response as the step output. The shape of the response depends on the action.

Use the full output reference in later steps:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Open **Integrations** and connect ClickUp if you have not already done that.
2. Add a **ClickUp** step to your workflow.
3. Select a connected account in **Authentication**.
4. Choose **Get authorized user** in **Action**.
5. Fill in the required fields. Use **Insert Variable** to reference an earlier step's output for any field value.
6. Click **Run** in the step header to test the action, then review the returned payload in **Output**.

## Use cases

### Create a task from a request

1. List lists
2. Create task
3. Create task comment

### Draft a project doc

1. Create doc
2. Create doc page
3. Get doc content

### Track work on a task

1. Get task
2. Create time entry
3. Update task

## Notes

* This step depends on a connected ClickUp integration in your workspace.
* The workflow action picker shows a curated set of actions. Agents with the ClickUp tool can use more of them.
* The sign-in screen may show third-party authorization branding.

## Using ClickUp as an Agent Tool

You can also add ClickUp as a tool in the **Agent Editor**. Open the agent, click **Add tool**, and select **ClickUp**. In the tool settings panel, choose the connected account the agent should use. The agent calls ClickUp actions when they are relevant to the conversation.

See also: [Integrations](https://docs.fetchhive.com/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/workflows/creating-and-editing.md), and [Testing and Iteration](https://docs.fetchhive.com/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.