Linking ClickUp as a source
This source is currently in alpha. The interface and available tables may change.
The ClickUp connector pulls your ClickUp data — workspaces, spaces, folders, lists, tasks, and goals — into the PostHog data warehouse.
Adding a data source
- Go to the sources tab of the data pipeline section in PostHog.
- Click + New source and then click Link next to ClickUp.
- You need a personal API token and your workspace ID from ClickUp. Generate a personal token (it starts with
pk_) under Settings → Apps in ClickUp. Your Workspace ID is the numeric ID in your ClickUp URL:https://app.clickup.com/{workspace_id}/.... - Back in PostHog, enter the
API tokenandWorkspace ID, then click Next. - Select the tables you want to sync, set the sync method and frequency, then click Import.
Once the syncs are complete, you can start using ClickUp data in PostHog.
Available tables
| Table | Description | Sync method |
|---|---|---|
workspaces | Workspaces your token can access | Full refresh |
spaces | Spaces within the workspace | Full refresh |
folders | Folders within each space | Full refresh |
lists | Lists (folderless lists and lists within folders) | Full refresh |
tasks | Tasks within the workspace | Incremental |
goals | Goals within the workspace | Full refresh |
Incremental tables sync only new or updated records on each run. Full refresh tables reload all data on each sync.
Sync limitations
Only the tasks table supports incremental sync, using date_updated as the cursor. The other tables are full refresh only.
Configuration
| Option | Type | Required |
|---|---|---|
API token | password | Yes |
Workspace ID | text | Yes |
Supported tables
| Table | Description | Sync method | Incremental field | Primary key |
|---|---|---|---|---|
workspaces | A ClickUp Workspace (Team) — the top-level container for spaces, members, and work. | Full refresh | — | — |
spaces | A Space within a workspace, grouping folders and lists for a team or area of work. | Full refresh | — | — |
folders | A Folder within a space that groups related lists. | Full refresh | — | — |
lists | A List of tasks, belonging either to a folder or directly to a space. | Full refresh | — | — |
tasks | A task — a unit of work tracked in ClickUp with status, assignees, and dates. | Incremental, Full refresh | date_updated | — |
goals | A Goal — a measurable objective tracked in ClickUp, made up of targets. | Full refresh | — | — |