This guide will inform you on how to integrate BambooHR for Global Payroll and enable our helpful plugins.
For more information about using Global Payroll with Deel, please see the Global Payroll Overview.
To install integrations on Deel, you must have the correct Org Admin-level permissions.
In this article
• Preparing your BambooHR
• Integrating Deel to BambooHR
• Onboarding the Global Payroll Employees plugin
• Data Mapping
• Syncing data & log report / Disabling Sync
• Payroll logs
• Auto-sync payslips & end-of-year tax documents plugin
• Global Payroll – Time-Off plugin
• Global Payroll – One-Time-Payment plugin
• Frequently Asked Questions
Before you begin
You will need:
• A BambooHR user with an Admin role
• A Deel user with an Org Admin (or Integrations Admin) role
Note: It may take several hours for updates and profiles to appear on BambooHR.
Preparing your BambooHR
✅ Step 1 – Create a Pay Group in BambooHR
A Pay Group is a standard BambooHR field used by payroll providers to understand how the employee is paid.
- Click the gear icon in BambooHR.
- Select Employee Fields > Pay Groups.
- Click New Pay Group and create an option for each entity that will run Global Payroll in Deel.
- Once created, assign the Pay Group in each employee’s Job tab.
✅ Step 2 – Assign Pay Group to employees
- Go to the employee’s Job tab.
- Select the correct Pay Group from the dropdown.
- Click Save changes.
A sync error will occur if an employee’s country of employment does not match the entity country of the selected Pay Group.
Integrating Deel to BambooHR
The steps below consolidate and replace the older numbered sequence, adding screenshots and troubleshooting guidance.
Overview
Follow these steps to connect BambooHR to Deel, verify the connection, and enable HRIS plugins.
Prerequisites
• Org/Admin-level permissions in Deel.
• The BambooHR sub-domain you sign in with (e.g. acme from acme.bamboohr.com).
Step-by-step instructions
1. Open the More menu in Deel
From the Deel dashboard click More in the top navigation bar.
2. Select Apps
3. Search for BambooHR
Use the Find apps search bar and click BambooHR – Complete HR software.
4. Enter your BambooHR sub-domain & authenticate
If the integration has not been connected before you will be prompted to:
1. Enter the company sub-domain.
2. Click Continue & Authenticate.
3. Log in to BambooHR and click Allow Access in the pop-up window.
Where can I find my sub-domain? It is the text before .bamboohr.com in your BambooHR URL.
5. Verify connection & enable plugins
When connected successfully the status reads CONNECTED and the plugins page is displayed.
If you see an authentication warning (e.g. Your authentication is invalid) click Reconnect BambooHR and repeat the login flow.
Success criteria
• Status = CONNECTED.
• Sub-domain is shown.
• Worker data sync (or any other required plugin) is ENABLED.
Troubleshooting
• BambooHR not found in search – check permissions.
• Status not connected – repeat authentication.
• Plugin errors – check on-screen message or contact Deel Support.
Onboarding the Global Payroll Employees plugin
This plugin lets you determine which BambooHR Pay Groups should create or sync Deel Global Payroll contracts.
✅ Step 1 – Open the plugin
- On the BambooHR integration page switch to Plugins and filter Global Payroll.
- Click Onboarding for Global Payroll Employees.
✅ Step 2 – Map Pay Group > Entity
Choose the BambooHR Pay Group that matches the Deel entity country.
✅ Step 3 – Add Group mapping
Select the Organisation reference and Group and click Add. Repeat for all required entities.
Once a Pay Group is mapped to an entity the mapping cannot be edited. Contact Deel Support for changes.
Data Mapping
By default Deel installs a standard mapping packet during set-up. Custom mapping can be configured – contact your onboarding or customer-success manager for assistance.
Syncing data & log report
After mapping is complete you can trigger a manual sync or let the automatic cadence run every 12 hours.
The last sync time is displayed on the BambooHR integration header.
Disabling Syncing (per entity)
If you need to pause the employee-data sync:
- Open Apps > BambooHR > Plugins (Global Payroll filter).
- Click Manage on Global Payroll – Employee data sync.
- If no entity is listed click Add entity and complete the wizard (required before the disable option appears).
- Click the ellipsis (⋯) next to the entity and choose Disable syncing.
You must configure at least one entity before you can disable syncing. Admin-level permissions required.
Payroll logs
Open the Payroll Logs tab to review the last sync, filter by errors and open the corresponding Deel contract or BambooHR profile.
Auto-sync Payslips & End-of-Year tax documents plugin
This plugin automatically pushes payslips and year-end tax documents to BambooHR (folder Year > Payslips).
- From Plugins enable Global Payroll – Auto Sync Payslip and End of Year (Tax document).
Documents are synced to BambooHR when they are published in Deel.
Global Payroll Time-Off plugin
Enables BambooHR to be the source of record for employee time-off.
- Enable Global Payroll Time Off.
- Drag & drop BambooHR time-off types to match each Deel PTO category.
Global Payroll – One-Time-Payment plugin
Makes BambooHR the source of variable pay & entitlements for Deel employees. Ensure the currency configured in BambooHR matches the entity currency in Deel.
Frequently Asked Questions
What types of data can be mapped?
• Global Payroll contract fields
• Additional Information fields
• Annual Compensation
What field types are not supported?
Payroll items.
How often will the integration sync?
Every 12 hours at HH:30.
Will there be notifications of integration issues?
Yes. In the BambooHR integration, click ⋯ > Email notification settings to add recipients.
Can workers be managed manually on Deel if BambooHR stops working?
Yes – disable the sync (see “Disabling Syncing” above), make your changes in Deel, then re-enable once BambooHR is available.