Teamtailor logoBambooHR logo

Recruitment to HR

Teamtailor to BambooHR integration: hired candidates as employees in BambooHR

With an integration between Teamtailor and BambooHR, every hired candidate from Teamtailor becomes a new employee in BambooHR, with start date, job title, department, location, employment status and salary from the offer. KoppelHet takes job title, department and location from the job, so recruiters do not have to fill in extra fields per candidate.

What the integration does

Organisations that recruit in Teamtailor and use BambooHR enter hired candidates in BambooHR by hand. Job, department and location are already on the job, but get filled in again.

  1. The recruiter moves the candidate to the hired stage in Teamtailor.
  2. KoppelHet retrieves candidate, job and offer.
  3. Job title, department and location come from the job and are translated to the lists in BambooHR.
  4. KoppelHet creates the employee with the contract type as the first status entry on the start date, and sets the salary with currency.
  5. CV and documents go to the folder you use in BambooHR.
Teamtailor → KoppelHet → BambooHRSOURCETeamtailorTARGETBambooHRKoppelHetmapping · logging · monitoringTeamtailor → KoppelHet → BambooHRSOURCETeamtailorTARGETBambooHRKoppelHetmapping · logging · monitoring
Out: New employee with name, email and phone · Job title, department, division and location · Start date and first employment status · Salary with currency · CV and documents

What to watch for with Teamtailor and BambooHR

  • Job title, department and location are on the job in Teamtailor. KoppelHet takes them from there, so recruiters do not have to fill them in per candidate and they are always right.
  • List fields in BambooHR only accept valid options. KoppelHet works with a fixed translation per field and reports it when a value is not in BambooHR's list.
  • KoppelHet takes salary and currency from the offer in Teamtailor, so a British colleague arrives in BambooHR in pounds and a Dutch one in euros.
  • Without a status entry a new colleague sits in BambooHR without an employment type, and reports on permanent and temporary staff then miss them. From the offer in Teamtailor KoppelHet sets the contract type as the first entry in the status history, effective on the start date.
  • KoppelHet puts documents in the BambooHR folder you choose, for example a separate folder for the signed contract.
  • KoppelHet's BambooHR user may only do what this flow from Teamtailor needs. That is creating an employee, adding a row to the compensation table for the salary from the offer and uploading documents.

How we build and run it

  • The integration runs on the KoppelHet platform, hosted in a data centre in the EU.
  • Every sync and every error is visible in the functional log; on an error your administrator is notified.
  • A change that cannot go through is not half-applied but queued for another attempt.
  • KoppelHet is ISO 27001 certified. Data travels encrypted and stays on the platform no longer than needed.
  • After go-live we manage the integration and adjust it when your process changes.
  • The integration fits next to your existing integration layer. Only the fields in the design are transferred; the platform keeps no register of its own.

Implementation, architecture and compliance

Implementation and price

This is not an app you switch on. We build the integration for your organisation on our platform, with building blocks we reuse on every project. So it is custom work that does not start from scratch.

A consultant prepares the intake and analyses both systems. We then record the mapping and exceptions field by field, test in the test or acceptance environment and go live at a moment you choose. Costs are a one-off amount for the setup and a monthly amount for platform, monitoring and support.

Price indication · Basic

Leave your work email and you see the price indication right away.

We only use your address to follow up on your question about this integration.

Frequently asked questions

What happens to rejected candidates?

They stay in Teamtailor. Only hired candidates go to BambooHR.

What about audit logging, GDPR and our integration platform?

You are the controller and KoppelHet is the processor, under a data processing agreement. Only hired candidates go to BambooHR, and every action is in the audit logging. An existing integration platform is left alone.

Technical details for IT

For those who want to know how it works under the hood: APIs, fields and sources used.

  • KoppelHet reads Teamtailor through the webhook job_application.update to a stage of the hired type and the Teamtailor API (job-applications, candidates, jobs with department and locations, job-offers and the onboarding add-on with start-date).
  • BambooHR is written through create-employee (employmentHistoryStatus with employeeStatusDate; list fields only with valid options), then create-table-row (v1.1) for compensation and upload-employee-file for documents.

Which fields are transferred

The key fields. The full mapping is agreed per customer.

Field in TeamtailorField in BambooHRNotes
first-name en last-namefirstName en lastName
emailhomeEmail
phonemobilePhone
title van de vacaturejobTitle
department van de vacaturedepartment
Locatie van de vacaturelocation
start-datehireDate
Contractsoort (custom field)employmentHistoryStatus met employeeStatusDate
Salaris en valuta uit het aanbodpayRate en currency
DocumentenEmployee files

Related

Which systems do you want to connect?

Tell us which systems you use and what should happen automatically. Together we define the smallest working solution, with a clear design and a quote before building.