Recruitment to HR
Teamtailor to HoorayHR integration: hired candidates as new colleagues in HoorayHR
With an integration between Teamtailor and HoorayHR, a candidate who moves to the chosen stage in Teamtailor automatically becomes a new employee in HoorayHR, with name, email, start date, job title, entity and team. KoppelHet takes those from the offer and the job in Teamtailor and adds the signed contract as an internal document.
What the integration does
Organisations that recruit in Teamtailor and use HoorayHR for personnel files, leave and sickness absence transfer new colleagues to HoorayHR by hand. HR fills in start date, job title and team again, and with several entities someone has to put the new colleague in the right place.
- An administrator in HoorayHR creates an API key with the scopes for employees and documents.
- The recruiter moves the candidate to the chosen stage in Teamtailor.
- KoppelHet retrieves candidate, job and offer and creates the employee in HoorayHR, with the signed contract as an internal document.
- The employee appears in HoorayHR as not invited; HR completes the record and an administrator sends the invitation.
What to watch for with Teamtailor and HoorayHR
- We advise against collecting the citizen service number and bank account in the recruitment system. HoorayHR has its own onboarding in which the new colleague fills them in.
- HoorayHR accepts start date, job title, entity and team when an employee is created. KoppelHet takes them from the offer and the job in Teamtailor, so HR does not enter them again.
- HoorayHR keeps the name prefix and surname separate, Teamtailor only has first and last name. KoppelHet takes the prefix out of the surname, so sorting and searching in HoorayHR works on the surname.
- Employees can be created in the HoorayHR API but not changed, and searching only works by ID. HR therefore adjusts a start date that moves after the hire, and KoppelHet remembers per candidate which HoorayHR employee was created, so a second stage change does not produce a duplicate colleague.
- HoorayHR can attach documents to an employee through the API, as internal or as visible to the employee. KoppelHet places the signed contract from Teamtailor as an internal document in the right category, so the new colleague only sees it once HR publishes it.
- Gender, civil status and country must come from a fixed list in HoorayHR. A freely entered value in Teamtailor does not always fit. KoppelHet translates the answers and reports an unknown value to HR.
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 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.
Frequently asked questions
Can the new colleague log in to HoorayHR straight away?
No. Employees created through the API are set to not invited; an administrator in HoorayHR sends the invitation.
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 company webhook job_application.update (signature v2 in TT-Signature; according to the docs no retry, so also an hourly check) and the Teamtailor API for candidate, job and offer. HoorayHR through POST /users (email required; firstName, insertion, lastName, gender, companyStartDate, jobTitle, entityId, teams as a list of team IDs) and POST /documents (userId, categoryId, fileData in Base64, status INTERNAL or PUBLISHED). API key of an administrator with scopes and expiry date.
Which fields are transferred
The key fields. The full mapping is agreed per customer.
| Field in Teamtailor | Field in HoorayHR | Notes |
|---|---|---|
first-name en last-name | firstName, insertion en lastName | KoppelHet splits off the name prefix |
email | email | Required on both sides |
phone | phone | |
Eigen veld geslacht | gender | Only values from HoorayHR's list |
Startdatum uit het aanbod | companyStartDate | |
Functie van de vacature | jobTitle | |
Afdeling of locatie van de vacature | entityId en teams |
Related
Teamtailor → ADP Workforce Now
Teamtailor to ADP Workforce Now integration: hired candidates as in-progress hires
Teamtailor → AFAS Profit
Teamtailor to AFAS integration: hired candidates straight in as new employees
Teamtailor → BambooHR
Teamtailor to BambooHR integration: hired candidates as employees in BambooHR
Teamtailor → BuddeeHR
Teamtailor to BuddeeHR integration: hired candidate as a new employee in BuddeeHR