Linking Jira as a source
This source is currently in alpha. The interface and available tables may change.
Enter your Atlassian Jira credentials to pull your Jira data into the PostHog data warehouse. The token authenticates as your Atlassian account, so the data we can sync is limited to the projects and issues that account can see.
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 Jira.
- You need three things from Atlassian:
- Subdomain – the
your-domainportion of your Jira URL (fromyour-domain.atlassian.net). - Email – the email address of the Atlassian account the token belongs to.
- API token – create one at id.atlassian.com/manage-profile/security/api-tokens.
- Subdomain – the
- Back in PostHog, enter the credentials 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 Jira data in PostHog.
Available tables
| Table | Description | Sync method |
|---|---|---|
issues | Issues across the projects your account can access | Incremental |
projects | Projects in your Jira instance | Full refresh |
users | Users in your Jira instance | Full refresh |
fields | Field definitions, including custom fields | Full refresh |
issue_types | Issue type definitions | Full refresh |
statuses | Workflow status definitions | Full refresh |
priorities | Priority definitions | Full refresh |
resolutions | Resolution definitions | Full refresh |
dashboards | Dashboards | Full refresh |
filters | Saved filters | 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 issues table supports incremental syncing, using Jira's server-side updated timestamp filter. Per-issue streams such as comments, worklogs, votes, watchers, remote links, and transitions are not synced, as each requires a separate request per issue and does not scale well on large instances.
Configuration
| Option | Type | Required |
|---|---|---|
Subdomain | text | Yes |
Email | Yes | |
API token | password | Yes |
Supported tables
| Table | Description | Sync method | Incremental field | Primary key |
|---|---|---|---|---|
issues | A Jira issue — a task, bug, story, or other unit of work tracked in a project. | Incremental, Full refresh | updated, created | — |
projects | A Jira project that groups issues and configuration. | Full refresh | — | — |
users | A user account that can access the Jira site. | Full refresh | — | — |
fields | A field (system or custom) available on Jira issues. | Full refresh | — | — |
issue_types | A type that categorizes Jira issues (e.g. Bug, Story, Task, Epic). | Full refresh | — | — |
statuses | A workflow status an issue can be in (e.g. To Do, In Progress, Done). | Full refresh | — | — |
priorities | A priority level that can be assigned to a Jira issue (e.g. Highest, High, Medium). | Full refresh | — | — |
resolutions | A resolution that explains how an issue was closed (e.g. Done, Won't Do, Duplicate). | Full refresh | — | — |
dashboards | A Jira dashboard that displays gadgets summarizing issues and activity. | Full refresh | — | — |
filters | A saved JQL filter in Jira used to find a set of issues. | Full refresh | — | — |