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

# Connect your app to ClickUp

> Connect your app to ClickUp, a work management platform for tasks, docs, and time tracking, to read and manage that work from your Lovable app.

[ClickUp](https://clickup.com/) is a work management platform for tasks, docs, and time tracking. The ClickUp connector lets your Lovable app read and manage tasks, lists, spaces, docs, and time entries from the ClickUp account you connect. It's designed for internal tools that bring a team's ClickUp work into the app.

ClickUp is available as an [app + chat connector](https://docs.lovable.dev/integrations/app-connectors.md): one shared connection that works in [Chats](https://docs.lovable.dev/features/chats.md), in the project chat while you build, and in your published apps.

With ClickUp, your app can:

* List tasks and update their status, assignees, due dates, and comments
* Read spaces, folders, and lists, and create tasks in a list
* Read and write docs
* Read and record time entries

It's a good fit for intake forms, project dashboards, and weekly time reports.

## Common use cases and example apps

These examples show what you can build with ClickUp, each with a prompt to start from.

| Example app | Example prompt | Description |
| :- | :- | :- |
| Request form | *Use ClickUp and build a form that creates a task in my Requests list, with the submitter's name and the request in the description.* | **Turn a submission into a ClickUp task.** The app creates the task in the list you name and writes the request into the description. |
| Open task list | *Use ClickUp and build a page that lists open tasks from my Sprint list, with status, assignee, and due date.* | **See what is still open in one list.** The app reads the open tasks in that list and shows status, assignee, and due date. |
| Task status updates | *Use ClickUp and build a page where my team can change a task's status and add a comment.* | **Keep status changes in ClickUp.** The app updates the task status and posts the comment on that task. |
| Docs reader | *Use ClickUp and build a page that lists docs in my workspace and shows a page in markdown when I open it.* | **Read ClickUp docs inside the app.** The app lists the workspace docs and loads the page you open as markdown. |
| Weekly time report | *Use ClickUp and build a report of this week's time entries for my workspace.* | **See where the week's time went.** The app reads the workspace's time entries for the week and lists each entry. |
| Workspace map | *Use ClickUp and build a page that lists my spaces, then the folders and lists inside the space I pick.* | **Find the right list before you create work.** The app reads the workspace's spaces and the folders and lists inside the one you open. |

## How to connect ClickUp

Who can create ClickUp connections depends on your plan and workspace settings. App + chat connectors are available by default. On Business and Enterprise plans, [Who can create connections and clients](https://docs.lovable.dev/integrations/admin-controls.md#who-can-create-connections-and-clients) starts at **Admins**. Some Enterprise workspaces start at **No one**, which disables the connector. An admin or owner changes it in **Connectors → Admin settings → App + chat connectors**.

You can create multiple ClickUp connections using different personal tokens, which is useful for separating environments (for example, development and production) or managing rate limits.

When the connection is created, you can [link it to the projects](https://docs.lovable.dev/integrations/app-connectors.md#link-a-connection-to-a-project) where you want to use it. Anyone building in a project can ask Lovable in the project chat to link their project to it. Linking follows the connection's access rules.

### Prerequisites

Before connecting ClickUp, make sure you have:

* A ClickUp account that can generate a personal token. ClickUp lets members and limited members with full edit permissions generate one. View-only limited members cannot generate one. See [ClickUp's API help article](https://help.clickup.com/hc/en-us/articles/6303422883095-Create-your-own-app-with-the-ClickUp-API).
* A ClickUp personal token
* Permission to **create connections** in your Lovable workspace (see [Who can create connections and clients](https://docs.lovable.dev/integrations/admin-controls.md#who-can-create-connections-and-clients))

> [!NOTE]
>
> All API requests through this connector count against the rate limit for that personal token. The limit follows the plan of the ClickUp workspace that hosts the token. See [ClickUp rate limits](https://developer.clickup.com/docs/rate-limits). Billing and plan limits are handled by ClickUp, not Lovable.

### Step 1: Get a ClickUp personal token

A personal token lets Lovable call ClickUp as you. It starts with `pk_` and has the same access as your ClickUp account, including every workspace that account belongs to. Your app can reach every one of those workspaces, so name the workspace or list in your prompt.

To create a ClickUp personal token:

**1. Open your ClickUp account**

Sign in to [ClickUp](https://app.clickup.com/).

**2. Open Apps**

In the upper-right corner, click your avatar, then select **Settings**. In the sidebar, click **Apps**.

**3. Generate a token**

Under **API Token**, click **Generate**. If a token is already there, click **Regenerate**. **Regenerate** replaces the previous token, and a Lovable connection that still uses it stops working until you update the token.

**4. Copy the token**

Click **Copy** and store the token securely. Personal tokens do not expire.

> [!WARNING]
>
> Your personal token functions like a password. Keep it secure and never share it publicly. You'll need it in the next step.

See ClickUp documentation for more: [ClickUp API authentication](https://developer.clickup.com/docs/authentication).

### Step 2: Connect ClickUp to Lovable

Paste the personal token into Lovable and choose who can use the connection.

**1. Open ClickUp in Connectors**

Open [Connectors](https://lovable.dev/dashboard?connectors) and select **ClickUp**. For the other places to open the catalog from, see [Where to find connectors](https://docs.lovable.dev/integrations/introduction#where-to-find-connectors).

**2. Add a connection**

Click **Connect** on the connector page. The form is split into collapsible sections, **Details**, **Configure connection**, and **Sharing**.

**3. Name the connection**

Under **Details**, Lovable fills in a name for the connection, which you can change. The name is only used inside Lovable to identify the connection.

**4. Configure the connection**

Under **Configure connection**, paste the token in **Personal token**. Click **Get value** to open [ClickUp Apps settings](https://app.clickup.com/settings/apps).

**5. Choose who can use this connection**

Under **Sharing**, the connection is private to you by default and shows a **Private** label. To share it, click **Share with others**. Then add workspace members by email, or click **Invite entire workspace** to make the connection available to everyone in your Lovable workspace.

People you share it with can use the connection in projects. Apps in their projects call ClickUp as your account, with your access. Lovable does not use another member's ClickUp connection in Chats, because the personal token belongs to your ClickUp account. Connect your own ClickUp account to use ClickUp in Chats.

See [Who can use connections and clients](https://docs.lovable.dev/integrations/admin-controls.md#who-can-use-connections-and-clients) for more information.

**6. Connect**

Click **Connect** at the bottom of the form. Lovable verifies the personal token against the ClickUp API before saving the connection.

When connected, anyone building in a project can ask Lovable in the project chat to link their project to ClickUp. Linking follows the connection's access rules. Your Lovable apps can then read and manage tasks, lists, spaces, docs, and time entries for the connected ClickUp account.

## Limitations

The ClickUp connector cannot:

* Support per-end-user ClickUp login. Each connection represents a single ClickUp account shared across all projects linked to it.

## Troubleshooting

Use these checks when connecting fails or a ClickUp request returns an unexpected status.

> [accordion] ClickUp did not validate your credentials
>
> Lovable could not call ClickUp with the token you pasted. The usual cause is a token copied in part, or one regenerated after you copied it. Copy the current token from [ClickUp Apps settings](https://app.clickup.com/settings/apps) and click **Connect** again.

> [accordion] The connection stopped working after I regenerated the token
>
> Regenerating a token in ClickUp replaces the token the connection saved. Open [Connectors](https://lovable.dev/dashboard?connectors), select **ClickUp**, and open the connection. Under **Configure connection**, click **Edit**, paste the new token in **Personal token**, and click **Update**.

## Manage your ClickUp connection

Connections are managed from [**Connectors**](https://lovable.dev/dashboard?connectors): select **ClickUp**, then open the connection.

* **Unlink projects** to remove ClickUp access from specific projects while keeping the connection available for others. See [Unlink projects from a connection](https://docs.lovable.dev/integrations/app-connectors.md#unlink-projects-from-a-connection) for the steps.
* **Delete the connection** to remove it from the workspace entirely. Deleting is permanent. It removes the credentials from all linked projects, and app features that use ClickUp stop working until a new connection is added. See [Delete a connection](https://docs.lovable.dev/integrations/app-connectors.md#delete-a-connection) for the steps and who can delete.
