Recruitment to HR
Recruitee to Personio integration: hired candidates straight into onboarding
With an integration between Recruitee and Personio, a candidate hired in Recruitee automatically appears in Personio, in onboarding, with start date, hours, position, department, entity and salary. Onboarding tasks for IT and the manager start on time, and HR no longer retypes anything.
What the integration does
Anyone who has Personio as HR system and uses Recruitee for recruiting instead of Personio's recruiting module enters every hire into Personio by hand, including hours and probation. Onboarding in Personio only starts once the employee exists there, so tasks for IT and the manager start too late.
- The recruiter marks the candidate as hired in Recruitee.
- KoppelHet checks that the notice really comes from Recruitee and fetches the candidate.
- The new colleague then appears in Personio, in onboarding, with start date, hours, department and entity.
- The fixed salary from the offer is in Personio too.
- The onboarding steps in Personio start from that moment. If something fails, the error shows in the KoppelHet platform.
What to watch for with Recruitee and Personio
- KoppelHet puts the new colleague into Personio with contract in one go, in onboarding status. The employee is there, but does not yet count as active.
- Personio does not accept two persons with the same email address. If a former employee applies with their old address, KoppelHet first checks whether the person exists and refers the case to HR.
- Because each notice creates a person in Personio, KoppelHet only processes notices that verifiably come from Recruitee.
- Besides weekly hours, Personio also asks for the full-time hours. With a Dutch collective agreement that uses a different full-time week, for example in care or education, KoppelHet sets the right full-time value per entity.
- Probation can be stored in Personio as an end date or as a length, not both. We use the end date, because a Dutch probation period is usually stated that way in the contract.
- Fixed and hourly pay go to Personio automatically, bonuses do not. A signing bonus from the offer therefore remains a task for HR or payroll.
- Recruitee already passes the vacancy's department with the hire. KoppelHet translates it to the right department in Personio.
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
Why not use Personio's recruiting module?
That is a choice per organisation. If you recruit in Recruitee, you keep that way of working and still get a complete employee in Personio.
Does Personio run Dutch payroll?
No. Personio supplies the data to a Dutch payroll such as Nmbrs or Loket. That is a separate integration.
Can the integration handle internal candidates?
Yes, but KoppelHet then creates no new person. The internal move goes to HR as a notice, and HR adjusts the contract in Personio.
Does KoppelHet work with Recruitee?
Yes, KoppelHet is a Recruitee partner. For the Recruitee side we use a building block we already have; the Personio side is tailored to your entities and departments.
Technical details for IT
For those who want to know how it works under the hood: APIs, fields and sources used.
- Recruitee is read through the signed candidate_moved webhook to a stage with the hire category (HMAC signature in the X-Recruitee-Signature header) and the ATS API with profile fields.
- Personio is written through the Personio API v2, which creates person and employment in one call (onboarding status), with first_name, last_name, email (unique), gender, weekly_working_hours, full_time_weekly_working_hours, position.title, org_units, office, legal_entity and probation_end_date.
- Salary goes through the compensation API (fixed and hourly, no bonus). API credentials with write access to persons and, if salary is included, to compensations.
Which fields are transferred
The key fields. The full mapping is agreed per customer.
| Field in Recruitee | Field in Personio | Notes |
|---|---|---|
name | first_name, last_name | The single Recruitee name field is split |
emails[0] | email | Must be unique in Personio |
Profielveld gender | gender | |
Startdatum (profielveld) | Startdatum van het dienstverband | |
Uren per week (profielveld) | weekly_working_hours | With full_time_weekly_working_hours for the part-time factor |
Functie (profielveld) | position.title | |
offer.department | org_units | Through the list of org units from Personio |
placement_locations[0] | office en legal_entity | Dutch placements to the Dutch entity |
Einde proeftijd (profielveld) | probation_end_date | |
Profielveld salary (amount, currency) | Compensatie (vast) |
Related
Recruitee → ADP Workforce Now
Recruitee to ADP Workforce Now integration: hired candidates as an in-progress hire
Recruitee → AFAS Profit
Recruitee to AFAS integration: from hired candidate to new employee
Recruitee → AlexisHR
Recruitee to AlexisHR integration: hired candidates as employees in Simployer One
Recruitee → BambooHR
Recruitee to BambooHR integration: hired candidates in BambooHR without clicking and retyping