Linking BugHerd as a source
Contents
This source is currently in alpha. The interface and available tables may change.
The BugHerd connector syncs your bug tracking and QA data – organization details, projects, tasks, and users – 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 BugHerd.
- You need an API key from BugHerd. Find it in BugHerd under Settings > General Settings (organization owner/admin access is required).
- Back in PostHog, enter the API key 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 BugHerd data in PostHog.
Available tables
| Table | Description | Sync method |
|---|---|---|
Organization | Your BugHerd organization details | Full refresh |
Users | Users in your BugHerd organization | Full refresh |
Projects | Projects in your BugHerd account | Full refresh |
Tasks | Tasks (bugs) across all projects | Incremental |
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 syncing, using BugHerd's updated_at timestamp filter. The API does not expose reliable timestamp filters for other endpoints, so they sync in full each run.
Configuration
Supported tables
The tables available from this source are discovered from your account when you connect it, so the exact list depends on your data. Once connected, you can pick which tables to sync from the sources tab.