Recruitment to HR
Teamtailor to BuddeeHR integration: hired candidate as a new employee in BuddeeHR
With an integration between Teamtailor and BuddeeHR, a candidate who reaches a hired stage in Teamtailor automatically becomes a new employee in Buddee, at the right company and with employment date and first day at work. Work email, division and manager from Teamtailor come along, so HR in Buddee only checks contract and salary.
What the integration does
Organisations that recruit in Teamtailor and use BuddeeHR for personnel files, leave and payroll preparation create each new colleague by hand in Buddee. With several companies in Buddee HR also has to work out which company the hire falls under.
- The recruiter moves the candidate in Teamtailor to the hired stage and fills the onboarding with start date and work email.
- KoppelHet checks the notification's signature and fetches application, candidate, job and onboarding.
- In Buddee a new employee appears at the company that belongs to the division.
- HR completes contract and salary in Buddee and sends the invitation.
- Buddee passes the employee on to Nmbrs or Loket through its own payroll integration.
What to watch for with Teamtailor and BuddeeHR
- Teamtailor currently does not retry a failed notification. If Buddee or KoppelHet is briefly unavailable, a hire would be missed. KoppelHet therefore searches Teamtailor every hour for applications that moved to a hired stage since the previous round.
- A new employee in Buddee requires both an employment date and a first day at work. Teamtailor has one start date in the onboarding. KoppelHet uses it for both, unless a custom field in Teamtailor holds a different first day at work.
- Buddee always creates an employee within a company. Teamtailor splits jobs over divisions. Per division we record the Buddee company, so a hire for the second operating company does not fall under the first.
- Teamtailor stores first and last name, Buddee also a separate name particle. KoppelHet takes van der or de out of the last name, so the employee sorts under the right letter in Buddee and later on the payslip.
- Buddee has a manager and a buddy for the first weeks per employee. KoppelHet looks up the job's hiring manager by email in Buddee and sets them as manager; a buddy only comes along if the recruiter picks one in a custom field.
- Teamtailor signs notifications with a timestamp and HMAC-SHA256 in the TT-Signature header. KoppelHet rejects notifications with an invalid or old signature, so nobody from outside can have an employee created in Buddee.
- Access to the Buddee API runs through a user account with email and password. We create a separate integration account with rights on employees only, so the integration does not stop when an HR colleague leaves or changes their password.
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
Do contract and salary come along too?
Not in the first version. HR records them in Buddee. Contract and salary from the offer in Teamtailor can be added later as an extension.
Technical details for IT
For those who want to know how it works under the hood: APIs, fields and sources used.
- Teamtailor through the job_application.update webhook (change of stage_id; signature v2 in TT-Signature with t= and v2=, HMAC-SHA256 over timestamp and raw body; no retry on a failed delivery) and the Teamtailor API (job-applications, candidates, jobs with division, onboarding with start-date and work-email). Missed notifications through a periodic query on job-applications.
- Buddee through the REST API on api.buddee.nl. Sign-in with basic auth on /auth/token, then a JWT as bearer. Employee with company_id, first_name, last_name, employment_date and first_day_at_work_date required; further last_name_prefix, work_email, personal_email, manager_id and buddy_id.
Which fields are transferred
The key fields. The full mapping is agreed per customer.
| Field in Teamtailor | Field in BuddeeHR | Notes |
|---|---|---|
first-name en last-name | first_name, last_name_prefix, last_name | Split the name particle |
email (kandidaat) | personal_email | |
work-email (onboarding) | work_email | |
start-date (onboarding) | employment_date en first_day_at_work_date | First day separately if it differs |
Divisie van de vacature | company_id | Through a translation table |
Recruiter of hiring manager van de vacature | manager_id | Matched on email address |
Custom field buddy (optioneel) | buddy_id |
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 → Cezanne HR
Teamtailor to Cezanne HR integration: hired candidates with the right start date and company in Cezanne