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
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.Candidate Transfer
The candidate record is then sent to BambooHR. Once a candidate is successfully sent, it cannot be resent from Talos.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 -.", | Fail | Minor | False |
"MessageTitle": "Upload Successful: Document -.", | 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.