> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/project-management/clickup-api/common-issues.md).
# Common Issues
## Connection issues
API token not accepted or connection fails
Make sure you're using your **personal API token**, not an OAuth token or a team token. Find it in ClickUp under your avatar → **Settings** → **Apps** → Personal API Token. Copy the full token without any extra spaces.
If the connection still fails, try regenerating the token in ClickUp and entering the new one in Coupler.io.
Data flow runs but returns no data
This usually means your API token doesn't have access to the spaces or tasks you're trying to export. ClickUp respects workspace permissions — if you're not a member of a space or it's set to private, those items won't appear.
Check that the ClickUp account associated with your token has the correct access level. If a workspace owner set up the token but the data lives in a space shared only with other members, you'll need a token from a user with access to that space.
## Missing data
Closed or completed tasks are missing
By default, closed tasks are excluded from the export. Go to the **Advanced settings** step in your data flow and enable **Include closed tasks**.
Lists entity shows only metadata, not tasks
This is expected behavior. The **Lists** entity returns list-level metadata (name, ID, status) — not the individual tasks inside. To get task data, add the **Tasks** entity to your data flow.
Deactivated users don't appear in time tracking data
ClickUp's API does not return time entries for deactivated users, even for dates when they were active. This is a ClickUp API limitation and cannot be worked around through Coupler.io settings.
Custom fields are missing from the export
Custom fields are available through the **List Custom Fields** and **Team Custom Fields** entities. Add one of these entities to your data flow. For task-level custom field values, they should also appear as separate columns in the Tasks export — if they're missing, try re-running the data flow after adding the relevant custom fields entity.
## Data discrepancies
Fewer rows than expected — data appears truncated
Enabling too many entities in a single data flow can cause API calls to fail or time out, resulting in partial data. If you're seeing fewer rows than expected, try splitting your entities across separate data flows rather than running them all at once.
Very large workspaces (tens of thousands of tasks) may also hit processing limits. Adding filters or splitting by space can help.
Time tracking totals don't match ClickUp's built-in reports
ClickUp's API does not return time entries for deactivated users (see above). If your ClickUp reports include historical time from users who have since been deactivated, the totals will differ. Also check that you're converting milliseconds to hours correctly — divide the `duration` field by 3,600,000.
## Rate limits
Sync fails with timeout or rate limit errors
ClickUp's API has rate limits that apply per token. Running many entities simultaneously (Tasks, Time Trackings, Users, Custom Fields, etc.) can trigger rate limit errors or timeouts.
{% hint style="warning" %}
If you're running more than 4–5 entities in one data flow, consider splitting them into separate data flows and staggering their schedules to avoid hitting API limits.
{% endhint %}
---
# 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.coupler.io/sources/category/project-management/clickup-api/common-issues.md?ask=&goal=
```
`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.