Skip to main content
All CollectionsPartner integrationsPartners
Partner: BambooHR (HR system)
Partner: BambooHR (HR system)

How to use integration with BambooHR

Success Team avatar
Written by Success Team
Updated over a month ago

By activating the BambooHR integration, you'll be able to add triggers that automatically send candidates from Teamtailor to the BambooHR platform.

BambooHR is an HR software that collects and organizes all the information you gather throughout the employee life cycle.

🆕 New improvement (Aug 2023) - The BambooHR integration now not only supports the transfer of resumes, but all candidate documents in Teamtailor. To enable this, make sure to create "Resumes and applications" as a default category in your Employee Files in BambooHR.



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 advice to activate 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 the 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: https://documentation.bamboohr.com/docs/list-of-field-names

When creating the custom field inside Teamtailor, you need to make sure the API field name of the custom field in Teamtailor, is matching 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, "bonusComment", 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


Need support?

Contact Teamtailor directly via:

Did this answer your question?