Skip to main content

BambooHR Integration

If your organization uses BambooHR, you can connect it to Branco to automatically sync employee data. This is optional — if you don't use BambooHR, your Branco Admin can manage users manually.

What it syncs​

The integration pulls the following from BambooHR into Branco on a daily basis:

  • Employee names and contact details
  • Manager assignments
  • Hire dates
  • Probation dates
  • Job titles (configurable field)
This is a one-way, read-only sync

Data flows from BambooHR into Branco only. Branco never writes back to BambooHR. Changes to employee data should always be made in BambooHR first — they'll sync over within 24 hours.

Prerequisites​

  • Your BambooHR subdomain (the part before .bamboohr.com in your URL)
  • API access or admin credentials for your BambooHR instance
  • IT Admin access to Branco

How to connect​

  1. Log in to Branco with your IT Admin account.
  2. Navigate to Integrations in the sidebar.
  3. Expand the "Other integrations" accordion.
  4. Enter your BambooHR subdomain in the text field.
  5. Click "Connect to BambooHR".
  6. The integration should activate and the first sync will run within 24 hours.

Configuration​

Two settings in Settings control sync behavior:

SettingDefaultWhat it does
HRIS_SYNC_ACTIVEOnToggle the daily sync on or off.
HRIS_SYNC_TITLE_FIELDjobTitleNameWhich BambooHR field maps to job title in Branco. Change this if your instance uses a custom field.
Check the title field

The most common issue after connecting BambooHR is job titles not syncing correctly. If titles look wrong, check that HRIS_SYNC_TITLE_FIELD matches the field name your BambooHR instance actually uses.

What to know about sync behavior​

  • New employees added in BambooHR will automatically appear in Branco after the next daily sync.
  • Manual edits in Branco get overwritten — If you change a user's title or manager directly in Branco, the next BambooHR sync will overwrite it with whatever's in BambooHR.
  • Deactivated employees — If someone is terminated in BambooHR, check that they're also deactivated in User Management. The sync may not handle deactivation automatically.
  • To pause the sync, toggle HRIS_SYNC_ACTIVE to Off in Settings. Existing user data in Branco will remain, but no new updates will pull from BambooHR.

Next: Troubleshooting →