Please note that the integration is available for Runn Pro and Runn Enterprise customers only.
This step-by-step guide will help you through the initial setup of the HR integration. We will start with setting up the time off sync for your existing people in Runn.
If you would like to use the HR integration tool to add new people to Runn, please follow the instructions here after the initial setup.
Set up Daily Time Off Sync for your existing people in Runn
Before you Start
Access
Ensure you have:
Admin access in Runn with Edit Account Settings and Data set as On
Admin access and credentials to your HR tool
If you don't have admin access to your HR tool, we suggest inviting your HR or IT admin as a Runn admin to authorize the integration. Once authorized, you can continue setting up the integration yourself.
Email addresses in Runn
You'll need to add email addresses to all people in Runn before you begin your integration. Runn uses email matching with your HR tool to avoid duplicate people being created.
Go to Manage > People
Click Bulk Edit
Choose Fix your data and click Next
Add email addresses to the people if needed
Switch to Test Account First
We strongly recommend you enable and test out the integration in your test account first. To switch to your sandbox environment,
Go to Settings > Switch to test account
Click Copy Live Account Data (it might take some time for the data to load)
Select your HR tool
Ensure you are in your test account
Go to Settings > Integrations
You will find a section called "Human Resource". Click Get Started.
Select BambooHR and click Next.
Connecting with the HR Tool
You will see a table in the next screen:
Scroll down until you see Time Off with the associated Behaviour as Daily Sync
Review the sync rules for time off here (link to main article)
For now, you can ignore all the People and Contracts fields (these fields will not be imported when you only select existing people in Runn to import)
Click Next
Authentication Procedures
Follow the authentication steps to link Runn with your HR tool. Authentication steps vary based on your HR tool.
Authentication Setup Guide
Please see the authentication setup guide for BambooHR here.
If you get stuck at any step, contact our support for help.
Once connected, Runn will automatically start syncing the data.
Depending on the number of employees and the HR tool, this may take up to 15 minutes.
Meanwhile, feel free to navigate away from the integration page. The sync will continue in the background.
Select people to import
Once you see the screen below, click Select People to Sync
Only select the people who are already in Runn. Make sure the email addresses match with their Runn’s email addresses.
Tip: You can import a subset of people to make sure the data is correct, then come back and import more people later.
Click Sync Selected
If the import is successful, you will see the following screen:
Since you are only importing the time off entries of the existing staff in Runn, People, Roles, Contracts and Teams imported should be 0.
You can click View Imported People to review a list of all the people you've just imported.
Review data on the People Planner
Go to the People Planner and check if the time-offs have been synced correctly into Runn.
If you have previously entered time offs directly in Runn, the synced time off will overlap them on the People Planner. You can delete the original time off in Runn if you like.
If you don’t see the time offs showing up immediately, it may be because the system is still taking some time to load.
If you still don’t see the time off entries after some time, please contact our support team via the in-app chat email us at help@runn.io
Reset the integration (if needed)
If there are errors in the data import, you may need to reset the integration and try again.
Go to Settings > Integrations
Turn off the integration with the toggle on the top left corner
Click the 3-dot icon to the right, select Disconnect BambooHR
Disconnecting the integration will retain the people and time off you have imported from the HR tool.
If you are in the test account, click Copy Live Account Data and try to set up the integration again.
If you are in the live account, you will have to manually delete all the time offs and try again.
Set up the integration in your Live Account
If everything goes well in your test account, go to your live account and repeat the above steps.
❗️Please make sure everything goes well in your test account before taking this step. Once the time offs have been added to your people in the live account, they can only be removed manually.