This guide will inform you on how to integrate BambooHR for Global Payroll and enable our helpful plugins.
If you want more information about using Global Payroll with Deel, please see Global Payroll Overview

In this article:
Onboarding the Global Payroll Employees plugin
Auto sync payslips and end of year tax documents plugin (Coming in Q1 2023)
Global Payroll - Time Off plugin
Global Payroll - One Time Payment plugin
Before you begin:
You must have both
- a valid BambooHR login
- You must be an Org Admin, IT Developer Admin, or Integrations Admin-People on Deel to set up this integration.

Note: It may take several hours for updates and profiles to appear on BambooHR.
Preparing your BambooHR
✅ Step 1 - Create the Pay Group in BambooHR
Pay Group is a standard field in BambooHR used for integrating with payroll providers to understand how the employee is getting paid.
You must have Admin permissions in BambooHR to proceed.
- Click on the Gear icon located at the top-right of your screen on BambooHR.
- Click on (1) Employee Fields in the left-hand menu
- In the sub-menu, find and select (2) Pay Groups
- To add your first Pay Group click (3) New Pay Group and create an option for each entity where you want to set up Deel Global Payroll.
If you have at least one option defined, you can assign a value for any employee you want to be synced to Deel within the Job tab for each employee under compensation.
✅ Step 2 - Assign Pay Group to employees
You must have Admin permissions in BambooHR to edit employee data
- Go to the Job tab of an employee
- You view and edit employee details like Hire Date, Standard Hours Per Week, Pay Group, EEO Job Category, and more.
- Select the Pay Group from the dropdown options
- Click on Save Changes to apply the selected Pay Group for the employee.
Follow the above steps for all employees you want to sync.
You may experience a sync error if the country of employment of an employee does not match the entity country of the pay group.
Integrating Deel to BambooHR
✅ Step 1 - Select Apps & Integrations from your home page
You must be an Org Admin, Integrations Admin, or Integrations Admin-People to set up this integration.
✅ Step 2 - Click BambooHR
✅ Step 3 - Click Connect
✅ Step 4 - Enter your BambooHR subdomain
How can I find my BambooHR subdomain?
To locate your subdomain log in to BambooHR and view your URL.
Your company subdomain is the string that precedes the BambooHR domain.


✅ Step 5 - Click Continue & Authenticate
You'll be asked to enter your BambooHR username and password on a new tab unless you are already logged in.
You may need to disable adblockers to see the new tab.
✅ Step 6 - Click Allow Access on the pop-up window
✅ Step 7 - Congratulations! You can now enable plugins
Onboarding the Global Payroll Employees plugin
The following steps will help you decide which entity team to create or sync Global Payroll contracts for, according to the BBHR pay group.
This step is highly sensitive so ensure to be very careful!
✅ Step 1 - Select Entity
Select the (1) Onboarding for Global Payroll Employees plugin.
In the Entity settings page, select an entity from the existing list or click (2) Add to add a new one.
✅ Step 2 - Select a Pay Group Entity (with reference to BambooHR) that matches the entity country.
Note: Take extra care to correctly complete this step to ensure that the pay group you select corresponds to the desired entity you are running payroll from
✅ Step 3 - Add Team
Global Payroll contracts require a team.
Select an Organization reference and Team. Click Add
Repeat the above steps for any other desired entities

Please be aware that once you have ‘used’ a pay group and entity, you cannot use them again.
You will not be able to delete or alter these mappings once approved. If you need to change, please contact the Deel support team.
Data Mapping
You may have a customized field setup, so data mapping is done on a case-by-case basis.
During the initial integration setup, Deel will install a default mapping packet. This can be customized to your needs.
We will help you set up your specialized data mapping, so please reach out to your onboarding manager or customer success manager for assistance.
Syncing data and log report
After you complete the mapping you will need to sync data by clicking Sync BambooHR in the integration.
A poll of your HR system will now sync in details for all the employees with a mapped pay group.
You can see the last time that a sync was completed in the top left corner.
Payroll logs
To view the log report from the last sync, select the Payroll Logs tab.
You can use this log report to open up a Bamboo profile or a Global Payroll contract (if available), to investigate any issue.
Auto Sync Payslip and End of Year tax documents plugin
This plugin allows you to sync payslips and end-of-year tax documents of your Global Payroll employees to BambooHR.
This allows your team to have easy access to these documents on BambooHR.
We will sync these documents to the yearly payslips folder in BambooHR.
We can only sync payslips and tax documents beginning from when you first enable the plugin.
To enable this plugin, Select the (1) Plugins tab and click (2) Enable Auto Sync Payslip and End of Year (Tax document)
Once this plugin is enabled, it will create a yearly folder and sync all payslips and the end-of-year tax documents into it.
Payslips and tax documents will sync to BambooHR when they are published in Deel.
Global Payroll Time Off plugin
This plugin makes your HRIS the source of worker time-off reporting when using Deel.
Once configured, any team member working as a Deel Employee for your team will enter time off into your HRIS instead of Deel.
To enable this plugin, click Enable on the Global Payroll Time Off plugin and begin matching the BambooHR time-off types to the Deel time-off types:
Global Payroll - One Time Payment
This plugin makes BambooHR the source of one-time payments when using Deel.
Once configured, any team member working as a Deel direct employee for your team will enter one-time payments into your HRIS instead of Deel. This can only happen for Deel employees linked to a HRIS profile.
Each Deel one-time payment type needs to be matched with at least one one-time payment type from the BambooHR one-time payment type list to complete the setup.
Please note that the OTP sync to Global Payroll only supports the entity's currency as defined in Global Payroll.
Please ensure that any Variable Pay or Entitlement you add in BambooHR follows the same currency used by the employee’s entity in Deel Global Payroll.
FAQs
[ACCORDION] What types of data can be mapped with this integration?
Currently there are three types of data that can be mapped
- Global Payroll contract fields
- Additional Information fields
- Annual Compensation
[ACCORDION] What field types are not supported?
Currently, these field types are not supported with the integration:
- Payroll items
[ACCORDION] How often will the integration sync?
The integration will automatically sync every 12 hours, at 30 minutes past the hour.