Linking Asana as a source
This source is currently in alpha. The interface and available tables may change.
The Asana connector pulls your Asana data — workspaces, users, projects, tasks, and more — 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 Asana.
- You need a personal access token from Asana. Create one from the Asana developer console. Grant these read scopes so every table can sync:
workspaces:read,users:read,projects:read,tasks:read,tags:read,teams:read, andcustom_fields:read. Copy the token value. - Back in PostHog, paste the token in the
Personal access tokenfield and 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 Asana data in PostHog.
Available tables
| Table | Description | Sync method |
|---|---|---|
workspaces | Workspaces your token can access | Full refresh |
users | Users across your visible workspaces | Full refresh |
projects | Projects in each workspace | Full refresh |
tasks | Tasks across all projects | Full refresh |
tags | Tags in each workspace | Full refresh |
sections | Sections within each project | Full refresh |
teams | Teams in each organization workspace | Full refresh |
custom_fields | Custom field definitions per 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
All Asana tables are full refresh only. Asana's list endpoints do not expose a usable server-side timestamp filter, so each sync reloads the full collection.
Configuration
| Option | Type | Required |
|---|---|---|
Personal access token | password | Yes |
Supported tables
| Table | Description | Sync method | Incremental field | Primary key |
|---|---|---|---|---|
workspaces | A workspace or organization — the highest-level container for all Asana data. | Full refresh | — | — |
users | A member of an Asana workspace or organization. | Full refresh | — | — |
projects | A collection of tasks with a shared purpose, owner, and timeline. | Full refresh | — | — |
tasks | A unit of work in Asana — the basic object around which tasks are tracked. | Full refresh | — | — |
tags | A label that can be applied to tasks to group and categorize them. | Full refresh | — | — |
sections | A grouping within a project that organizes its tasks. | Full refresh | — | — |
teams | A group of users within an organization that share projects and conversations. | Full refresh | — | — |
custom_fields | A custom field definition used to add structured metadata to tasks and projects. | Full refresh | — | — |