BambooHR is an HR software that helps you collect and manage employee information throughout the entire employee lifecycle.
By activating the BambooHR integration, you can set up triggers that automatically transfer candidates from Teamtailor to the BambooHR platform.
This integration supports the transfer of not only resumes but also all candidate documents from Teamtailor. To ensure this works correctly, make sure to create a default category called "Resumes and applications" in the Employee Files section of your BambooHR account.
Getting started in Teamtailor
To enable the integration between BambooHR and Teamtailor, you connect your existing BambooHR account to Teamtailor through our Marketplace page. Head over to the marketplace in the Teamtailor application, search for BambooHR, and click Activate.
Add the requested details in the fields and click on "Activate" to set up the integration.
You find your BambooHR subdomain in the URL when you are logged into BambooHR (it's the first part before Bamboo).
We advise activating the extended data migration to allow the transfer of custom fields.
The API you need to create in Teamtailor is with the scope Admin Read. You can find more about creating API keys in this article.
This will open a pop-up window, which will ask you to authenticate with your BambooHR account. If you are already logged in to BambooHR, this will automatically authenticate without you having to log in again. Once you've done that, the connection has been made, and the integration should be activated on your account!
Set up the workflow in Teamtailor
The Candidate is automatically sent to BambooHR via a trigger you add to a stage in the recruitment process.
How to set up custom fields
The integration supports custom fields to be transferred from Teamtailor into BambooHR. The list of supported custom fields can be found here.
When creating the custom field inside Teamtailor, you need to make sure the API field name of the custom field in Teamtailor matches the API field name inside BambooHR's documentation.
If the API field name in BambooHR is just one word, for example, "city" the API field name in Teamtailor should look like this:
In cases where the API field name in BambooHR consists of several words put together, for example, "Additional comment", the API field name in Teamtailor should look like this:
The title of the custom field can be named whatever you like, as long as the API field name is correctly set up.
In order for the custom field to be transferred together with the candidate data to BambooHR, it needs to have a value added on the candidate card before the integration is triggered on the candidate.
Set salary currency
If you hire employees in different countries, their salaries may be in different currencies. If you don't want to use the default currency in your BambooHR account or manually update it later, you can select the correct currency in advance directly from Teamtailor. This way, the salary will automatically appear in the right currency in BambooHR. Find the steps to follow to set up the salary currency from Teamtailor:
Create a custom field type Number for the salary. The API name for this custom field should be pay-rate.
Create a second custom field, type Text/Select, for the currency. Here, the API name should be currency.
The currency should be written with its abbreviation, for example Euro = EUR, British Pounds = GBP, American dollars = USD
Populate the salary and currency fields on the candidate card.
Fields sent to BambooHR
First name
Last name
Email address
Phone
Custom fields (full list of custom fields available here)
Candidate documents