Skip to main content

Partner: BambooHR (HR system)

Learn how to integrate Teamtailor with BambooHR

Theo avatar
Written by Theo
Updated over 2 weeks ago

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.

Fields sent to BambooHR

  • First name

  • Last name

  • Email address

  • Phone

  • Custom fields (full list of custom fields available here)

  • Candidate documents

Did this answer your question?