Recruitment to HR
Teamtailor to Sage HR integration: hired candidates with team, location and manager in Sage HR
With an integration between Teamtailor and Sage HR, a hired candidate from Teamtailor becomes a new employee in Sage HR, with start date, job title, team, location, manager and the signed contract. KoppelHet sets team, location, manager and leave approver right per candidate, without the recruiter filling in extra fields.
What the integration does
Organisations that recruit in Teamtailor and have Sage HR as their HR system enter starters in Sage HR by hand. HR assigns team, manager and leave approver there per starter.
- The recruiter moves the candidate to the hired stage in Teamtailor.
- KoppelHet retrieves candidate, job, department, location and the accepted offer.
- KoppelHet creates the employee in Sage HR with name, work address and start date, without a welcome email.
- Then team, location, country, manager and leave approvers follow on the same employee.
- The signed contract goes to the document category HR chooses; the salary becomes a task for HR.
What to watch for with Teamtailor and Sage HR
- KoppelHet reads the start date from the accepted offer or the onboarding in Teamtailor, so recruiters do not need to fill in an extra field.
- KoppelHet determines the team per candidate from department and location, even when one job recruits for two teams.
- A location in Teamtailor holds the country in full, such as Sweden, while Sage HR expects a two-letter country code and the nationality in full, such as Dutch. KoppelHet translates both, so Sage HR does not reject the employee over a country name.
- A department in Teamtailor has a manager. KoppelHet looks that person up in Sage HR and sets them as manager and as leave approver, so the starter's first leave request does not end up with nobody.
- The salary in a Teamtailor offer is free text, such as 50,000 per month with a currency sign, and the public Sage HR API can only read compensation. KoppelHet therefore does not put the salary in Sage HR itself, but turns it into a task for HR with the amount from the offer.
- A Teamtailor candidate's email is the address they applied with, and in Sage HR the email becomes the login address. With Teamtailor's onboarding add-on there is a work address for the starter; KoppelHet uses that address for Sage HR and keeps the private address out.
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
Does the new colleague get an invitation from Sage HR straight away?
No. KoppelHet switches off the welcome email at creation; HR invites the starter at the moment that suits.
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 Sage HR, 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 company webhook job_application.update (signature in TT-Signature) and the Teamtailor API with X-Api-Version (job-applications, candidates, jobs, departments with manager, locations, job-offers with status accepted and details.start-date, onboardings with start-date and work-email). Limit 50 requests per 10 seconds.
- To Sage HR through {subdomain}.sage.hr/api with X-Auth-Token. POST /employees (required email, first_name, last_name; work_start_date, send_email false, position_title, nationality, country), then PUT /employees/{id} with team_id, location_id, leader_id, approver_ids and employee_number, and POST /documents with employee_id, category_id and notify.
Which fields are transferred
The key fields. The full mapping is agreed per customer.
| Field in Teamtailor | Field in Sage HR | Notes |
|---|---|---|
first-name en last-name | first_name en last_name | |
work-email (onboarding) of e-mail kandidaat | email | Login address in Sage HR |
start-date uit het aanbod of de onboarding | work_start_date | YYYY-MM-DD |
title van de vacature | position_title | |
department van de vacature | team_id | |
location (country voluit) | location_id en country | Country as two-letter code |
manager van de afdeling | leader_id en approver_ids | |
Getekend contract | Document met category_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 → BuddeeHR
Teamtailor to BuddeeHR integration: hired candidate as a new employee in BuddeeHR