Follow these steps to connect your BambooHR account with RemotePass
1. General Setup
Before You Start
Administrator access — only BambooHR admins can generate an API key and manage permissions.
Email alignment — ensure the home or work email in BambooHR matches the email in RemotePass (if the worker already exists).
Aligned policies — review your time-off policies in BambooHR and RemotePass to avoid sync mismatches guideline.
Step 1 – Configure BambooHR
Generate a new API key from the BambooHR API Access page — See guide
Create a custom field named (exactly) "Remotepass Employment Type".
For each worker you want to sync, set this field to the appropriate value (EOR, DE, Contractor).
Step 2 – Connect to RemotePass
In RemotePass, go to Integration Settings → BambooHR.
Enter your BambooHR subdomain and API key.
Confirm the connection.
2. Worker Sync Setup
Go to integration page and click Enable for Worker Sync
Review the pre-defined field mappings for worker data sync and click continue. (You may adjust or add more mappings at this step for faster contract creation)
Click Continue, and you are ready for worker sync!
3. Time-Off Sync Setup
Go to integration page and click Enable for Time-off Sync..
Select the contract types you want to include in the sync. Only the selected contract types will have their time off synced from BambooHR.
Click Continue — the sync begins and the integration is enabled.
You are all set!
5. Configure which policies affect compensation
In Module Settings under Manage time-off policies sync, choose which policies should be paid out. These settings are used later for termination calculations. For example, only Annual Leave enabled as a paid leave policy in the image below.
Frequently Asked Questions
Worker Sync
Do I need to configure field mapping myself?
Usually no. The native integration comes pre-filled and ready to use. However, if you have custom needs, you can always update the mapping. We still recommend reviewing it during setup and taking action if necessary.
Can I choose which workers are included in Worker Sync?
Yes. Only workers with the Remotepass Employment Type field filled in BambooHR (e.g., Contractor, DE, or EOR) will be imported into RemotePass.
What if I disable the integration?
Turning off Worker Sync stops future updates but does not remove past synced amendment entries. Workers in the Imported Workers list (not yet converted to contracts) will be deleted, while any contracts you’ve already created will remain. Fully disconnecting BambooHR halts all integration features.
Time-off Sync
Do I need to align all leave policies before enabling the sync?
No. We display your time off policies and worker balances on BambooHR as it is. You can see all of your policies (for synced workers) under the Company Settings> Time off Policies > BambooHR Policies tab.
What if I disable the integration?
Turning off the time-off sync stops future updates. If you enable it again, system would pick up the current balance and policies of the worker.
Why the balance displayed on RemotePass is different than BambooHR?
RemotePass displays the BambooHR balance as of today. Due to accrual rules or pro-rated calculations and future-dated approved requests, there might be differences between the displayed balances on BambooHR and RemotePass. We get and display the the worker balance future-dated once you select the termination date, on the termination form.
What if a worker edits or cancels the time-off request on BambooHR?
It would be automatically updated to RemotePass as edited or canceled.