Recruitment to HR
Workable to Personio integration: hire with the real start date, hours and salary in Personio
With an integration between Workable and Personio, a candidate in Workable's Hired stage becomes a person with employment in Personio, with the start date from the offer, legal entity, department, office, hours and salary. The Workable integration in Personio also creates an employee, but fills in as date the moment the candidate moved to Hired; KoppelHet comes in when contract date, hours and salary must be correct in Personio.
What the integration does
Organisations that recruit in Workable and use Personio as their HR system often have the Workable integration switched on. Afterwards HR changes the hire date in Personio to the contract date and fills in hours, probation and salary from the offer.
- The recruiter moves the candidate to the Hired stage in Workable.
- KoppelHet retrieves candidate, job and offer and checks that the offer was accepted.
- KoppelHet checks in Personio whether the email address already belongs to someone; if so, HR decides.
- KoppelHet creates person and employment in onboarding status, with the start date from the offer.
- The salary goes to Personio as a fixed amount or hourly wage, with the start date as effective date.
What to watch for with Workable and Personio
- The Workable integration in Personio fills the hire date with the moment the candidate moved to Hired. Personio means the start of the contract by that date. KoppelHet uses the start date from the accepted offer, so leave, probation and pay count from the right day.
- With the Workable integration, values such as the office name must be exactly the same in both systems. KoppelHet translates location and department through a table, so an office with a different name in Workable still lands at the right office in Personio.
- Workable knows legal entities per account, and Personio works per entity. KoppelHet takes over the job's legal entity, so a hire for the Dutch BV does not end up under the German GmbH.
- The salary in a Workable offer has an amount, an interval and a currency. Through the API Personio accepts a fixed amount or an hourly wage with an interval, but no bonus. KoppelHet picks the type from the Workable interval and turns a bonus into a task for HR.
- An email address may only belong to one person in Personio. If a former employee comes back through Workable with the same address, KoppelHet creates nothing and passes the case to HR, instead of a hire that fails silently.
- Workable sends the candidate in a notification as it is at the moment of sending. KoppelHet therefore first checks that the offer was accepted, and only then creates someone in Personio.
- Next to the hours per week, Personio asks for the entity's full-time hours. Workable has no fixed field for hours; we add them as a variable in the offer template and fill in the full-time hours per entity.
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 just the Workable integration in Personio?
It is quick to set up and often enough when HR reviews every new hire. Custom work pays off when contract date, hours and salary must be right without manual work.
In which status does the new employee arrive?
In onboarding. The employee is there, but does not count as active until the start.
Does Personio run Dutch payroll?
No. Personio supplies data to a Dutch payroll; that is a separate integration.
Technical details for IT
For those who want to know how it works under the hood: APIs, fields and sources used.
- Workable through a subscription on candidate_moved with stage_slug hired (X-Workable-Signature, HMAC-SHA256). Then GET /candidates/:id, /jobs/:shortcode, /legal_entities and /candidates/:id/offer (state accepted; document_variables; salary with amount, frequency and currency_iso). Token with read scopes only.
- Personio through POST /v2/persons (person and employment in one call; status ONBOARDING; employment_start_date, weekly_working_hours, full_time_weekly_working_hours, legal_entity, office, org_units, position.title; email unique) and POST /v2/compensations (type, value, effective_from, interval; no bonus).
Which fields are transferred
The key fields. The full mapping is agreed per customer.
| Field in Workable | Field in Personio | Notes |
|---|---|---|
firstname en lastname | first_name en last_name | |
email | email | Unique in Personio |
Juridische entiteit van de vacature | legal_entity | |
Locatie van de vacature | office | |
department van de vacature | org_units (department) | |
title van de vacature | position.title | |
Document variable start_date uit het aanbod | employment_start_date | Not the date the candidate moved to Hired |
Uren per week (document variable) | weekly_working_hours en full_time_weekly_working_hours | |
salary (amount, frequency, currency_iso) | Compensation met interval |
Related
Workable → ADP Workforce Now
Workable to ADP Workforce Now integration: from the Hired stage to an in-progress hire per ADP company
Workable → AFAS Profit
Workable to AFAS integration: a candidate in the hired stage starts onboarding in AFAS
Workable → BambooHR
Workable to BambooHR integration: hire with salary interval and later changes
Workable → Dayforce
Workable to Dayforce integration: hire from the Hired stage, validated first