1. Home
  2. General Topics
  3. Synerion- BambooHR integration

Synerion- BambooHR integration

Setting up the BambooHR Integration

The BambooHR Employee Integration allows importing employees from BambooHR into Synerion Agile. The BambooHR system will act as a master file system and this is a one-way synchronization. The integration supports adding new employees and updating existing ones. The integration is expected to run on a scheduled basis. (e.g., once every hour or so…) and requires a one –time setup per customer.

This Document details:

  • Connecting Synerion to BambooHR
  • Configuring Synerion Specific Fields – called user defined fields
  • Synchronizing employees and organizational hierarchy

Connecting Bamboo to Synerion

Before we can connect Bamboo to Synerion, the customer must have purchased the Synerion system, specifying that they want to connect to Bamboo, and have a scheduled session with Synerion implementation. In addition, the Bamboo system should be already set up when this process begins.

Order the Synerion App from the BambooHR marketplace

When the Synerion App gets installed, inform Bamboo support, and they will create a tab in your system called “Synerion”

This tab will be populated with fields that exist in Synerion but not in BambooHR. Creating them in Bamboo prevents users from having to go in to Synerion and populating them for new employees and a single point employee management between the systems. If the tab has not been created please contact Bamboo support to create it. It is only necessary to populate fields that more than 1 value and are not defaulted.

Here are the list of fields:

Custom Field Display Name Type Required or Optional Examples Description
1 WorkRule Work Rule Single Select


Required 0700-1500 No Lunch

0700-1530 Lunch

0900-1700 No Lunch

This defines how employee’s hours are calculated (i.e. work policy)
2 PeriodSelection Period Selection Single Select


Required Weekly 40

Weekly 44

This defines employee’s pay period and period overtime rules
3 HolidayGroup Holiday Group Single Select


Optional Ontario Stats


This defines the employee’s statutory holidays policy

Not all employees are entitled to stat pay, hence the need for a “None” option

4 AccrualGroup Accrual Group Single Select


Optional Standard Benefits


This defines the employee’s accrual benefits policy

Not all employees are entitled to benefits, hence the need for a “None” option

5 EssGroup ESS Group Single Select


Optional Timesheet Employees


This defines employee’s self-service security configuration

Not all employees have access to ESS, hence the need for a “None” option

6 BadgeNumber Badge Alphanumeric

Max Length (20)

Optional 100



Some customers use proximity cards etc. where the badge is different from the employee number.

These customers can define the badge / card number via UDF. Usually numeric but can also be alpha

Synerion Implementation team will tell you which values to add for each category.

Here is an example on how to add a work rule value:

  1. Select the field ‘Work Rule’ and add the values.

There are two ways to assign these values to employees:

  1. Assign a value to multiple employees at one time.
  2. Assign by individual employee

Assign Value to multiple employees at one time

  1. Login to BambooHR, under People click on gear icon and select ‘Power Edit Employee.’

  1. From ‘Available Employees’ select the employees (you can multi select employees) and move to ‘selected employees’

  1. Next choose the field from ‘Synerion’

  1. Next you can choose from either option: Individually or as a group and click ‘Next Step’.

  1. Select the values from the dropdown for each individual employee and click ‘Next Step’.

  1. Preview your changes and click ‘Save and Finish’.

  1. If you choose as Group update at step 4, select the value from the dropdown and click ‘Next Step’.

  1. Preview your changes and click ‘Save and Finish’.

You can similarly continue for remaining User Defined fields like Period Selection, Holiday Groups, Accrual Groups and ESS Groups.

Assign by individual employee

  1. Login to BambooHR, under People select the employee ‘Synerion’ tab is displayed with all custom fields.

Select the value from the dropdown.

Connecting to the Synerion System

This step will be done with Synerion implementation

During your implementation Synerion will navigate to the implementation portal and specify your BambooHR company domain from your BambooHR URL (companydomain.bamboohr.com).

Once this is inputted into the UI, the implementer will press “GET APKI KEY…” and will be redirected to the BambooHR login screen.

The user will input their credentials, and then the two systems will be connected.

Step 3: Synchronizing employees and organizational hierarchy

Once the two systems are connected there will be a flag that shows the API key is set in the implementation portal.

The implementer will then build the organizational hierarchy by pressing the “Test Department Interface” button.

Clicking on this button, it validates the credentials, and it displays the preview of the departments that will be created in Synerion. It gets Department Number and Name directly from BambooHR. The user can preview the departments. It is not saved into the system yet.

The next step is to test the employees coming over from the source system by pressing “Test Employee Interface”.

All the employees will display on the screen with all the relevant values. This can be exported to excel if it is simpler to review that way. Again, this is for verification purposes, nothing has been imported yet.

The final step is to run the employee interface. This can be run manually but future runs will be scheduled to run every X hours.

Updated on June 29, 2021

Was this article helpful?

Related Articles

Need Support?
Can’t find the answer you’re looking for? Don’t worry we’re here to help!

Leave a Comment