Set up the BambooHR integration for EOR – Deel

This article explains how to set up the BambooHR integration on Deel for EOR employees. Once connected, changes and additions to contracts managed in Deel are automatically reflected in your organisation's BambooHR profiles, giving you improved organisational visibility and accuracy.

To install integrations on Deel, you must have Org Admin permissions.

Before you begin

To set up the integration, you will need:

A BambooHR user with an Admin role
A Deel user with an Org Admin, Integrations Admin, or Integrations Admin – People role

It may take several hours for updates and profiles to appear in BambooHR. The integration syncs automatically every 12 hours, at 30 minutes past the hour.

Setup steps

Step 1: Connect Deel to BambooHR

Go to More > Apps and search for BambooHR.
Enter your BambooHR subdomain and click Next.
Click Continue and authenticate. Enter your BambooHR username and password in the new tab that opens.
Click Allow Access on the user consent pop-up.

How to find your BambooHR subdomain

Log in to BambooHR and look at your URL. The subdomain is the string before .bamboohr.com. For example, in acme.bamboohr.com, the subdomain is acme.

You may need to disable ad blockers for the authentication tab to open.

Step 2: Enable the Profile bulk creator

This plugin is enabled by default when the integration is installed. It allows you to bulk create BambooHR profiles for active workers hired through Deel, including both contractors and EOR employees.

Go to the Plugins tab and click Manage next to Profile bulk creator.
Review the group members list. Deselect any members you want to exclude, or click Re-sync to refresh the list. Click Next.
Select the contract types you want to create profiles for. By default, profiles are created for all active group members. Click Next.
Click Create Profiles.

Step 3: Enable Profile auto creator and Job info updater

This plugin automatically creates BambooHR profiles for new group members on an ongoing basis and keeps employment and compensation details up to date when contracts are signed or amended in Deel. It is triggered when contracts are fully countersigned in Deel.

There are three sub-options you can activate independently:

Sub-option	Description
Profile creation	Automatically creates a BambooHR profile when a group member signs their contract in Deel
Employment status	Automatically updates the employment status in BambooHR when it changes in Deel
Compensation	Automatically adds a new compensation row in BambooHR when pay is updated in Deel

Go to the Plugins tab and click Enable next to Profile auto creator and Job info updater.
Click Activate next to the sub-option you want to enable.
Map the Deel contract type to the corresponding BambooHR employment status. Deel offers four contract types: Fixed, Pay As You Go, Milestone, and EOR Employee.
Click Activate to confirm.
Repeat steps 2–4 for any additional sub-options you want to enable.

At least one contract type must be mapped to a BambooHR employment status for auto-syncing to activate. To edit a sub-option after activation, click the pencil icon next to it.

Step 4: Enable Document sync

This plugin syncs documents from Deel to the employee's BambooHR profile. Only documents that admins already have access to in Deel are synced.

Go to the Plugins tab and click Enable next to Document sync.
Toggle on the document types you want to sync. Available types include the contractor agreement, DPA agreement, passport or national ID, and more.

Synced documents are accessible from the Documents tab on the employee's BambooHR profile. Deel only syncs payslip information for EOR employees who have enabled sharing on their Deel profile.

Step 5: Enable EOR time off

This plugin allows EOR employees to log time off in BambooHR. Deel reads time off information from BambooHR and syncs it to Deel periodically. This plugin is available for Deel EOR employees linked to a BambooHR profile only.

Go to the Plugins tab and click Enable next to EOR Time off.
Drag and drop items from the BambooHR list into the corresponding Deel boxes.

Click Enable Plugin.

There must be at least one item from the BambooHR list in each Deel EOR box. Deel only supports time off types that are configured in your system.

Frequently asked questions

Does the integration sync balances?

No. The integration does not sync or reconcile leave balances between BambooHR and Deel.

Why are there discrepancies in balances between the two systems?

Discrepancies can occur if the total allowance in BambooHR differs from what is set up in Deel. To resolve this, align your BambooHR policy with Deel's settings. If alignment is not possible, contact your Customer Success Manager to discuss adjusting the Deel contracts.

Why are the total allowances not the same in both systems?

BambooHR may have PTO policies that differ from those in Deel, which can lead to differences in accrual logic. Any necessary adjustments must be made manually to ensure consistency.

Does the integration support multiple BambooHR accounts?

No. Only one BambooHR account can be connected at a time. We recommend consolidating your data into a single BambooHR account, or using two separate Deel accounts.

Data syncing reference

The BambooHR integration for EOR supports three sync mechanisms. Each handles a different type of data. Together, they keep worker data and documents automatically up to date across both platforms.

The integration syncs every 12 hours, at 30 minutes past the hour. It may take several hours for updates and profiles to appear in BambooHR.

Mechanism	Trigger	Sync direction
Profile auto creator	Contract fully countersigned in Deel	Deel to BambooHR
Job info updater	Contract signed or amended in Deel	Deel to BambooHR
Document sync	Document published or available in Deel	Deel to BambooHR

Profile auto creator

When a new EOR worker's contract is fully countersigned in Deel, the Profile auto creator automatically creates a corresponding employee profile in BambooHR. The following fields are forwarded at the time of profile creation.

Personal information

Field	Description
firstName	Worker's first name
lastName	Worker's last name
middleName	Worker's middle name
displayName	Preferred display name
dateOfBirth	Date of birth
homeEmail	Personal email address
workEmail	Work email address
bestEmail	Primary/preferred email address
workPhone	Work phone number

Address

Field	Description
address	Full address
address1	Street address line 1
city	City
state	State or region
zipcode	Postal/ZIP code
country	Country

Employment information

Field	Description
hireDate	Worker's hire date
status	Current worker status
employmentHistoryStatus	Employment status history entry
employeeStatusDate	Effective date of employment status
jobTitle	Worker's job title
location	Work location
department	Department
division	Division
jobEffectiveDate	Effective date of job information

Compensation and payroll

Field	Description
payRate	Worker's pay rate
payRateEffectiveDate	Effective date of the pay rate
overtimeRate	Overtime pay rate
payPer	Pay frequency (for example, hour, week, month)
payType	Pay type (for example, salary, hourly)
payGroupId	Payroll group identifier

Tax and compliance

Field	Description
ssn	Social Security Number
customTaxFileNumber1	Tax file number (custom field)
customNIN1	National Insurance Number (custom field)

Custom fields

Field	Description
4045	Custom BambooHR field
4046	Custom BambooHR field
4047	Custom BambooHR field

Job info updater

The Job info updater keeps employment and compensation details in sync after the initial profile is created. It is triggered when contracts are signed or amended in Deel.

Sub-option	Data synced	Description
Employment status	Employment status	Updates the worker's employment status in BambooHR when it changes in Deel
Compensation	Compensation	Adds a new compensation row in BambooHR when the worker's pay is updated in Deel

Department is forwarded by the Profile auto creator at the time of profile creation. It is not updated by the Job info updater when changes are made after the profile has been created.

Document sync

The Document sync plugin pushes worker documents from Deel to the employee's BambooHR profile. Synced documents are accessible from the Documents tab on the employee's BambooHR profile, at the next scheduled sync after they become available in Deel.

Document	Notes
Contractor agreement
DPA agreement
Passport or national ID
Payslips	EOR employees only. Worker must have enabled sharing on their Deel profile.
Other compliance documents	As configured

Only documents that admins already have access to in Deel are synced to BambooHR.

Field coverage summary

Field category	Profile auto creator	Job info updater	Document sync
Personal information	Yes	No	No
Address	Yes	No	No
Employment information	Yes	Yes	No
Compensation and payroll	Yes	Yes	No
Tax and compliance	Yes	No	No
Documents	No	No	Yes

Video Tutorial

If a video works better, here is a short tutorial for the BambooHR integration:

In this article