Skip to main content

Bamboo HR

Learn how to get setup with Bamboo HR within Talos to onboard candidates

Adam Kavanagh avatar
Written by Adam Kavanagh
Updated this week

Talos has several HR providers integrated within the system.

Learn how to setup Bamboo HR within your ATS, so you can onboard candidates directly into your HR system.

Note: you will need access to the Integrations Management administration permission to setup the integration

Setup

Required Information

To setup Bamboo HR with your Talos ATS, you will need the below information:

  • Company Domain - Found in your BambooHR URL,. https://{companyDomain}.bamboohr.com. Please do not include the forward slashes.

  • Company Code - to generate your company code, when logged into your Bamboo HR system, click your name in the lower left-hand corner and click on the 'API Keys' option. If you do not have the option for 'API Keys', your permissions will need to be updated in Bamboo HR.

Note: in your BambooHR system you need to add a Folder called TalosATS to allow documents to be passed from Talos into Bamboo HR. Without this folder being present no information will be sent across.

Warning: if the person who authenticated the connect has their user account disabled on Bamboo HR, the connection will need to be re-authenticated by another admin user.

Bamboo HR support will be able to assist in providing you with your Company Domain if this is not known.

You will also need the data values for the below fields, from your Bamboo HR system, so these can be added to the relevant data capture forms in Talos:

  • Department

  • Division

  • Job Title

  • Location

  • Pay Schedule

Once all the details have been provided by Bamboo HR to you, you will be able to set this up in Talos.

Linking Bamboo HR to Talos

Go to the Talos Marketplace and find the 'Bamboo HR' integration and click on 'Connect':

Click on 'Enable this Integration' and complete the required fields and click on 'Save' to link the integration with your ATS:

Once the details have been saved, the integration tile will be updated on the home page of the Integrations to show this is connected:

Additional Information

There are two data capture forms used to gather data for Bamboo HR one internal and one external, the remaining data is taken from core data on Talos.

Information: the below values are for example purposes only.

BambooHr - New Starter Form - External

Field

Value

Required

Date Of Birth

25/06/2001

Yes

Gender

Male

Yes

Marital Status

Single

Yes

NI Number

AA010203B

Yes

BambooHR - New Starter Form - Internal

Field

Value

Required

Department

Finance

Division

Asia-Pacific

Exempt

Exempt

Job Title

Customer Success Advocate

Location

London, UK

Pay Rate (0.00)

Pay Type

Hourly

Paid Per

Day

Pay Schedule

Twice a month

Pay Frequency

Weekly

Include In Payroll

Yes

Time Tracking Enabled

Yes

Standard Hours Per Week

BambooHr – Core data

Field

Value

Required

Address1

13 Elm Street

City

Liverpool

Country

United Kingdom

First Name

John

Yes

Flsa Code

Yes

Hire Date

22/01/2025

Original Hire Date

22/01/2025

Home Email

Yes

Home Phone

01744812612

Last Name

Jones

Yes

Mobile Phone

07123456789

Data Flow

  1. Folder Check
    Talos verifies whether the folder TalosATS exists. If the folder is missing, an error message is returned to the ATS. After creating the folder, you can resend the candidate.

  2. Candidate Transfer
    The candidate record is then sent to BambooHR. Once a candidate is successfully sent, it cannot be resent from Talos.

  3. Document Transfer
    After the candidate is sent, their documents are transferred. Each document will return either a success or an error message.

Responses

Response

Report Type

Report Level

Is Resendable

"MessageTitle": "Error: Missing Required Fields",

"Message": "Please ensure all required connection details are completed before continuing."

Fail

Major

True

"MessageTitle": "Error: Missing File Category",

"Message": "The folder 'TalosATS' is missing from your BambooHR account. Please create or configure this folder and try again."

Fail

Major

True

"MessageTitle": "Error: Employee Import to BambooHR Failed",

"Message": "@{variables('Error Message')}"

Fail

Major

True

"MessageTitle": "Import Successful: Employee Added to BambooHR",

"Message": "The employee has been successfully imported into BambooHR."

Success

Major

False

"MessageTitle": "Upload Failed: Document -.",
"Message": "We weren’t able to upload this document.",

Fail

Minor

False

"MessageTitle": "Upload Successful: Document -.",
"Message": "The document has been successfully uploaded.",

Success

Minor

False

Additional Setup

Please see our 'HR Connect - Additional Setup' guide for further information on additional configuration options and linking your HR Provider to your ATS workflows.

Did this answer your question?