The BambooHR integration was designed to allow you to easily launch a Workflow for each candidate that is hired. We use BambooHR's native webhook capabilities along with information from their API in order to launch your Enboarder Journeys. Here's how it works!

Before you begin: Like anything worth doing, integrations take time. Please allow up to 4 weeks for this integration to be completed, this includes time for scoping, development and testing. You’ll also need to have a system expert and/or system administrator to assist in the completion of this integration.

Click the hyperlinks below to skip to that topic!

When a candidate is hired by clicking on the 'Hire' option, a dialog box will open showing the button 'Add New Employee'. Clicking this button will allow you to fill out the info required to hire the candidate and get them on their way to Enboarder.

All candidates are converted to employees when an offer is signed and the candidate is marked as hired in BambooHR. You will need to enter the hire date and the email address or mobile number while creating the new employee record.

Instead, we'll be launching them into Enboarder. All that's left is to click 'Save' to launch the new hire's onboarding Workflow!

A BambooHR Admin must first log in to BambooHR and copy your custom BambooHR domain prefix. If your custom domain is https://enboardersandboxaccount.bamboohr.com, then copy just the 'enboardersandboxaccount' part.
​
While logged in, you should also go to Settings > Account > Webhooks. Please check that you have permission to add webhooks to the system by clicking 'Add Webhook'.

We'll return to configure this webhook later!

This step requires an Enboarder Admin to paste the custom BambooHR domain prefix and copy your custom webhook URL.

First, navigate to Settings > Apps & Integrations > App Center.

Click on the tile 'BambooHR' tile.
​

When you click on 'Add Integration' you will be asked to enter the BambooHR custom domain prefix from our previous step. 

To exclude certain hires from being launched into Enboarder, you can use the 'Additional Filter' line within the Integration Tile in Enboarder.

In order to determine which employees do launch in Enboarder, and which don't, you can apply a simple filter as below:

{{BambooHRColumnName}} = {{possible values comma separated}}

For example - if the column name is Department, and the possible values are Sales or Marketing then the filter will be: Department=Sales, Marketing

This will mean that anyone being hired with their department as either Sales or Marketing WILL launch to Enboarder. But in this case, if you're hiring someone in Support, they will NOT launch to Enboarder.

You'll also see the custom Webhook URL on the tile as well which you'll need to copy and pop into Bamboo a bit later on.

Once you've copied the Webhook URL, click 'Integrate Now' which will open up the Bamboo HR log-in page, where you will log in with your BambooHR Admin credentials.

Once you've passed the admin authentication, Enboarder will mark the tile as integrated.

Next, your BambooHR admin will log in and go to Settings > Account > Webhooks and click on 'Add Webhook' as tested in the first step.

Provide a name for the new webhook such as 'Enboarder Integration'. Please select 'Hire Date' from the choice 'What fields do you want to monitor'.

In the next section provided, called 'What fields do you want to post', select the fields which you want to send across to Enboarder. (See note below).

Please note that the below fields are mandatory to select in order for Integration to work:

Enboarder needs either the email or mobile of the employee. At least one of the below fields should be populated with a valid value:

In the next section you see, please select the following:

Below is the mapping that we have already done for you with regard to launching. This means that you won't need to adjust names in Bamboo or Enboarder for the below.

For anything else (like custom fields) names must match accordingly in both systems.

To send employee data back into BambooHR, you will need to configure the HRIS API in a send data webhook module. Please see the detail of this API at https://documentation.bamboohr.com/reference.

If you want to update an employee's details or get an employee's information, you will need to pass the employee ID in the URL. In this case, add a new Custom Field, 'empid', in your Enboarder workflow. The system will auto-populate this data when data is pushed into Enboarder from BambooHR's webhook. You can use this for updates or RestAPI GET requests.

The BambooHR API uses basic-auth for authentication. You will need to first get the API key from the BambooHR portal > APIKeys. Create a key if one does not already exist.

Once a key is created, then you will need to encode an apikey:x and complete the header information. You can use any online tool to encode this information.

In the request header, the key will be Authorization and value will be Basic EncodedString as shown in the below image.

Your custom payload should be designed in the same JSON structure required by the BambooHR API documentation.

You can now investigate mapping issues very easily from the Enboarder logs. The API response is now available in your Enboarder account. Please go to Settings > Apps & Integration > Integration Logs to view the complete payload. There may be multiple rows for each new hire. One row contains the complete response message and the others will provide info from the webhooks.

Click on a row with a blank 'Employee' field to see the complete payload.

The webhook URL is changed. Earlier our endpoints started with the below:

The admin can select the option to select the option Launch, Update and Cancel mode.

Steps:

2. Now the admin can select the mode in which Integration will work. Please select the mode and save the integration.

Here are the options provided

(Relaunch is launching a brand new Workflow, it doesn't restart a canceled Workflow)

In Bamboo HR, the admin can configure multiple webhooks or they can configure multiple columns to watch. Based on this, Enboarder can receive multiple webhooks with different data for the same employee.

Steps:
1. Login in bamboo HR. Go to Settings → Account → Webhooks and click Add Webhook button

2. Provide the name of the webhook. Please select fields from What fields do you want to monitor

To terminate an employee in BambooHR,

In the webhook add Employment Status as a field to monitor and to receive the termination request.

Making changes in Bamboo HR for the candidate could result in the candidate launching multiple times in Enboarder. In order to prevent a candidate from experiencing multiple launches, simply click the "Enforce Candidate ID as Unique ID" checkbox in the Enboarder. If you have already integrated, simply update the integration and ensure this box is checked!

If you have any questions about this process, don't hesitate to reach out to the Support team by clicking the '?' button at the top right of any Enboarder page. Alternatively, you can email us at support@enboarder.com 🎉