Linking BambooHR as a source
Contents
This source is currently in alpha. The interface and available tables may change.
The BambooHR connector syncs your HR data – employees, time off requests and types, and account metadata – into PostHog.
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 BambooHR.
- Next, you need your company subdomain and an API key from BambooHR. Your company subdomain is the first part of your BambooHR URL (for example
yourcompanyinyourcompany.bamboohr.com). To generate an API key, go to Account Settings → API Keys (this requires admin permissions) and make sure the key has access to the data you want to sync. - Back in PostHog, enter the credentials in the
Company subdomainandAPI keyfields 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 BambooHR data in PostHog.
Available tables
| Table | Description | Sync method |
|---|---|---|
employees | Employee directory | Full refresh |
time_off_requests | Time off requests | Full refresh |
time_off_types | Time off type definitions | Full refresh |
meta_fields | Field definitions in your account | Full refresh |
meta_lists | List field options | Full refresh |
meta_users | Users with account access | 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 BambooHR tables are full refresh only – the BambooHR API does not expose a verified "modified since" filter that returns complete records, so each sync reloads all data.
Configuration
| Option | Type | Required |
|---|---|---|
Company subdomain | text | Yes |
API key | password | Yes |
Supported tables
| Table | Description | Sync method | Incremental field | Primary key |
|---|---|---|---|---|
employees | An employee in the company directory. | Full refresh | — | — |
time_off_requests | A time-off request submitted by an employee. | Full refresh | — | — |
time_off_types | A category of time off configured for the company (e.g. vacation, sick). | Full refresh | — | — |
meta_fields | A field definition available in the company's BambooHR account. | Full refresh | — | — |
meta_lists | A list field and its available option values configured in BambooHR. | Full refresh | — | — |
meta_users | A user account with access to the company's BambooHR. | Full refresh | — | — |