# ClickUp

ClickUp is a project management platform where teams track tasks, manage workflows, log time, and organize work across spaces, folders, and lists. Connecting ClickUp to Coupler.io lets you pull that data into spreadsheets, BI tools, or AI assistants — without manual exports.

**Why connect ClickUp to Coupler.io?**

* Export tasks, time tracking, goals, and team data to Google Sheets, BigQuery, Power BI, Looker Studio, Excel, or AI tools like ChatGPT, Claude, or Gemini
* Combine multiple ClickUp entities (e.g., Tasks + Time Trackings) using Join or Append transformations to build richer reports
* Keep your dashboards and reports up to date with scheduled syncs
* Access custom fields from lists and teams as structured columns in your destination

## Prerequisites

* A ClickUp account with access to the workspaces you want to export
* A ClickUp personal API token (found in your ClickUp profile settings)
* Coupler.io account (free plan available)

{% hint style="warning" %}
Coupler.io pulls data based on your personal API token. You'll only see spaces, tasks, and users that your ClickUp account has permission to access. Private spaces or tasks shared with other members won't appear unless your account has explicit access.
{% endhint %}

## Quick start

{% hint style="success" %}
Start with the **Tasks** entity — it's the most data-rich ClickUp entity and the most common starting point for project reporting.
{% endhint %}

{% stepper %}
{% step %}
**Get your ClickUp API token.** In ClickUp, click your avatar in the bottom-left corner, go to **Settings**, then scroll to **Apps**. Click **Generate** (or copy your existing token) under Personal API Token.
{% endstep %}

{% step %}
**Create a new data flow in Coupler.io.** Go to your Coupler.io dashboard and click **Add data flow**. Search for and select **ClickUp** as the source.
{% endstep %}

{% step %}
**Enter your API token.** Paste your ClickUp personal API token into the connection field and click **Connect**.
{% endstep %}

{% step %}
**Select an entity.** Choose the data you want to export — for example, Tasks, Time Trackings, or Team Goals. You can add more entities to the same data flow later.
{% endstep %}

{% step %}
**Choose a destination.** Select where you want your data to land — Google Sheets, BigQuery, Power BI, Excel, Looker Studio, or an AI destination like ChatGPT or Claude.
{% endstep %}

{% step %}
**Run your data flow.** Click **Run** to execute a manual sync. Once it completes successfully, your data will appear in the destination.
{% endstep %}
{% endstepper %}

## Available entities

| Entity             | What it contains                                         |
| ------------------ | -------------------------------------------------------- |
| Tasks              | Task details, statuses, assignees, due dates, priorities |
| Time Trackings     | Time entries logged against tasks                        |
| Time Tracking Tags | Tags used in time tracking entries                       |
| Users              | Workspace members and their details                      |
| Teams              | Workspace/team structure                                 |
| Spaces             | Top-level spaces in a workspace                          |
| Folders            | Folders within spaces                                    |
| Lists              | Lists within folders or spaces                           |
| List Custom Fields | Custom field definitions for lists                       |
| Team Custom Fields | Custom field definitions for teams                       |
| Space Tags         | Tags defined at the space level                          |
| Team Goals         | Goals tracked at the team level                          |
| List Comments      | Comments on lists                                        |


---

# Agent Instructions: 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:

```
GET https://docs.coupler.io/sources/category/project-management/clickup-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.