Linking BambooHR as a source
Contents
Alpha release
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 |