FAQ

chevron-rightWhere do I find my ClickUp API token?hashtag

In ClickUp, click your avatar in the bottom-left corner, go to Settings, then scroll down to Apps. Your personal API token is listed there — click Generate if you haven't created one yet, or copy the existing token.

chevron-rightWhy am I only seeing list names, not the tasks inside them?hashtag

The Lists entity in Coupler.io returns list-level metadata — the list name, ID, and settings — not the tasks inside. To get task data, add the Tasks entity to your data flow.

chevron-rightCan I export custom fields from ClickUp?hashtag

Yes. Add the List Custom Fields or Team Custom Fields entity to your data flow. Custom field values also appear as separate columns in the Tasks export. If you recently added new custom fields in ClickUp, re-run the data flow to pick them up.

chevron-rightWhy doesn't my data flow return all my tasks?hashtag

Two common reasons: first, closed tasks are excluded by default — enable Include closed tasks in Advanced settings. Second, if you're running many entities at once, some API calls may fail and return partial data. Try splitting entities across separate data flows.

chevron-rightWhy are deactivated team members missing from time tracking exports?hashtag

ClickUp's API does not return time tracking entries for deactivated users. This applies even to historical entries logged before the user was deactivated. Unfortunately, this is a ClickUp API limitation that cannot be resolved through Coupler.io settings.

chevron-rightCan I combine ClickUp data from multiple workspaces?hashtag

Yes. Create a separate data flow for each workspace (using the API token of a user in that workspace), then use the Append transformation in Coupler.io to combine them into a single dataset in your destination.

chevron-rightShould tasks and time trackings go into the same table in BigQuery?hashtag

No — they have different schemas and should be stored in separate tables. Use a Join transformation in Coupler.io if you want to combine them, or reference them with separate queries/views in BigQuery. Appending them into the same table will cause schema conflicts.

chevron-rightCan I send ClickUp data to AI tools like ChatGPT or Claude?hashtag

Yes. Coupler.io supports AI destinations including ChatGPT, Claude, Gemini, Perplexity, Cursor, and OpenClaw. This lets you query your ClickUp task or time tracking data conversationally — useful for generating status summaries or identifying blockers.

chevron-rightWhy does my data flow run successfully but show no data?hashtag

This usually means the API token you used doesn't have access to the spaces or tasks you're trying to export. ClickUp respects workspace permissions — private spaces and tasks you're not a member of won't appear. Make sure the token belongs to a user with the appropriate access level.

circle-info

For a full list of available fields and metric combinations, see the Data Overview article. For connection errors and partial data issues, check Common Issues.

Last updated

Was this helpful?