Linking Linear as a source
Let AI connect your sources for you
Skip the manual setup — run this in your project and the wizard auto-detects your databases and APIs and connects them to PostHog.
Contents
The Linear connector can link issues, projects, teams, users, comments, labels, cycles, and resources to PostHog.
To link Linear:
Go to the sources tab of the data pipeline section in PostHog.
Click + New source and then click Link next to Linear.
Log in to your Linear account and authorize PostHog to access your data.
Select the tables you want to sync and modify the method and frequency as needed. Once done, click Import.
Once the syncs are complete, you can start using Linear data in PostHog.
Configuration
| Option | Type | Required |
|---|---|---|
Linear account | oauth | Yes |
Supported tables
| Table | Description | Sync method | Incremental field | Primary key |
|---|---|---|---|---|
issues | A unit of work tracked in Linear — a task, bug, or feature request. | Incremental, Full refresh | updatedAt | — |
projects | A collection of issues working toward a common goal, with a timeline and progress. | Incremental, Full refresh | updatedAt | — |
teams | A team in the Linear workspace that owns issues, projects, and a workflow. | Full refresh | — | — |
users | A member of the Linear workspace. | Full refresh | — | — |
comments | A comment left by a user on an issue or project in Linear. | Incremental, Full refresh | updatedAt | — |
labels | A label that can be applied to issues to categorize them. | Full refresh | — | — |
cycles | A time-boxed sprint of work for a team, with a set of issues and a date range. | Incremental, Full refresh | updatedAt | — |
resources | An attachment linking an issue to an external resource (a URL, document, or integration). | Incremental, Full refresh | updatedAt | — |
workflow_states | An issue workflow state (status) belonging to a team, such as Todo, In Progress, or Done. | Incremental, Full refresh | updatedAt | — |
project_milestones | A milestone marking a checkpoint within a project, grouping issues due by a target date. | Incremental, Full refresh | updatedAt | — |
initiatives | A strategic goal that groups related projects together across the workspace. | Incremental, Full refresh | updatedAt | — |
team_memberships | The membership of a user in a team, including whether they own it. | Full refresh | — | — |
issue_relations | A directed relationship between two issues, such as blocks, blocked by, related, or duplicate. | Full refresh | — | — |
project_updates | A written status update posted on a project, recording its health at a point in time. | Incremental, Full refresh | updatedAt | — |
documents | A document written in Linear, optionally attached to a project, initiative, or issue. | Incremental, Full refresh | updatedAt | — |