FaRecruitment to HR
Teamtailor to Factorial integration: hired candidates with a contract in Factorial
With an integration between Teamtailor and Factorial, a candidate who reaches the chosen stage in Teamtailor becomes an employee in Factorial, with name, email, contract, legal entity, hours and probation. KoppelHet creates the employee and the first contract with start date and hours in one go.
What the integration does
Organisations that recruit in Teamtailor and use Factorial as HR system enter new colleagues in Factorial by hand. HR creates the contract with start date, hours and probation separately, and an existing email address blocks a new employee.
- The recruiter moves the candidate in Teamtailor to the chosen stage.
- KoppelHet checks whether the email address already belongs to an employee in Factorial.
- The employee and the first contract are created in one go.
- HR sends the invitation from Factorial when it suits.
- KoppelHet compares the candidates on the stage with Factorial daily.
What to watch for with Teamtailor and Factorial
- Manager ID and Legal Entity ID are internal Factorial numbers that a recruiter does not know. KoppelHet translates the job's department and location into those numbers.
- Factorial does not allow two employees with the same email address. KoppelHet checks this beforehand and puts a returning employee to HR.
- Factorial wants the new employee's login address as email, not the personal address. Teamtailor only knows the address the candidate applied with, so the work address must be in a custom field beforehand.
- Factorial expects nationality and country as a two-letter country code. If Teamtailor says Netherlands instead of NL, KoppelHet converts the value.
- Hours are stored in Factorial as a percentage of a full-time week in hundredths, for example 8000 for eighty percent. KoppelHet converts the contract hours from the offer using the entity's full-time week.
- Teamtailor does not retry a failed webhook delivery. KoppelHet therefore compares the candidates on the chosen stage with the employees in Factorial every day, so a missed notification still produces an employee.
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 Factorial run Dutch payroll?
No. Factorial supplies the data to a Dutch payroll; that is a separate integration.
Does the new colleague get access to Factorial straight away?
No. HR sends the invitation from Factorial.
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 (stage_id change, HMAC SHA-256 in TT-Signature) and the Teamtailor API. Teamtailor does not retry a failed delivery, so KoppelHet compares the candidates on the stage with Factorial daily.
- To Factorial through API version 2026-10-01, POST /resources/employees/employees/create_with_contract (required company_id, first_name, last_name, email; further legal_entity_id, manager_id, contract_starts_on, contracts_working_time_percentage_in_cents, has_trial_period, nationality, country).
Which fields are transferred
The key fields. The full mapping is agreed per customer.
| Field in Teamtailor | Field in Factorial | Notes |
|---|---|---|
first-name en last-name | first_name en last_name | |
Zakelijk e-mailadres (eigen veld) | email | Login address, not the personal address |
Locatie van de vacature | legal_entity_id | Through a lookup table |
Afdeling van de vacature | manager_id | Through a lookup table |
Eigen velden Nationality en Country | nationality en country | Two-letter country code |
start-date (onboarding) of eigen veld | contract_starts_on | |
Uren uit het aanbod | contracts_working_time_percentage_in_cents | Converted to a share of the full-time week |
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