> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kombo.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Visma Raet - Youforce HRIS Integration
> Visma Raet - Youforce connector for Kombo's HRIS API
The Visma Raet - Youforce HRIS integration allows you to sync HRIS data between Visma Raet - Youforce and your application through Kombo's unified API. The tool slug for this connector is `youforce`.
## Guides and Resources
Step-by-step instructions to connect your Visma Raet - Youforce account to Kombo.
## Supported Features & Coverage
| Field | Notes |
| ------------------- | ----- |
| id | |
| remote\_id | |
| changed\_at | |
| remote\_deleted\_at | |
| name | |
| address | |
| Field | Notes |
| --------------------- | ----- |
| id | |
| remote\_id | |
| changed\_at | |
| remote\_deleted\_at | |
| employee\_number | |
| first\_name | |
| last\_name | |
| display\_full\_name | |
| job\_title | |
| work\_email | |
| personal\_email | |
| mobile\_phone\_number | |
| gender | |
| employment\_status | |
| employment\_type | |
| weekly\_hours | |
| work\_location\_id | |
| manager\_id | |
| home\_address | |
| date\_of\_birth | |
| start\_date | |
| termination\_date | |
| custom\_fields | |
| integration\_fields | |
| remote\_data | |
| Field | Notes |
| ------------------- | ----- |
| id | |
| remote\_id | |
| changed\_at | |
| remote\_deleted\_at | |
| employee\_id | |
| job\_title | |
| employment\_type | |
| effective\_date | |
| remote\_data | |
| custom\_fields | |
| integration\_fields | |
| Field | Notes |
| ------------------- | ----- |
| id | |
| remote\_id | |
| changed\_at | |
| remote\_deleted\_at | |
| name | |
| type | |
| parent\_id | |
| Field | Notes |
| ------------------- | ----- |
| employee\_id | |
| team\_id | |
| id | |
| changed\_at | |
| remote\_deleted\_at | |
For detailed information about [creating employees with form](/hris/implementation-guide/create-employee), please see the [**Create Employee with Form** tab](#create-employee-with-form) above.
| Input Field | Notes |
| -------------------- | ----- |
| staffing\_entity\_id | |
| properties | |
| Feature | Notes |
| ------------------ | ----- |
| Connection Guide | |
| Create credentials | |
| API Passthrough | |
| Scope Testing | |
Youforce creates hires through an asynchronous HSS workflow. Kombo waits for that workflow and surfaces any validation error it reports, but the new employee only appears in Kombo on a later sync, once Youforce has finished processing it.
Hires run through an HSS workflow that must be configured on the customer's Youforce tenant. The workflow that runs — and which fields it treats as mandatory (e.g. some require payroll client/institution codes) — depends on that tenant's setup.
**Workflow Name**
Optional override for the HSS workflow to start, sent as `X-Raet-Workflow`. Must exactly match a workflow name configured on the customer's Youforce tenant (case-sensitive). When omitted, Youforce starts the default workflow configured for this endpoint.
**Last Name**
The last name of the employee
Unified field: `last_name`
**Last Name at Birth Prefix**
Optional Dutch tussenvoegsel for the birth name (e.g. `de`, `van der`).
**First Name**
The name the person is commonly known by.
Unified field: `first_name`
**Initials**
**First Names**
**Gender**
When omitted, Youforce defaults to `Unknown`.
Unified field: `gender`
**Date of Birth**
The employee's date of birth
Unified field: `date_of_birth`
**Birth Place**
**Birth Country**
**Title Prefix**
Title shown before the name.
**Title Suffix**
Title shown after the name.
**Marital Status**
**Last Name Preference**
Youforce code controlling how the displayed last name is composed from the birth and partner names (e.g. `E` for the birth name).
**Partner's Last Name**
**Partner's Last Name Prefix**
Optional Dutch tussenvoegsel for the partner name.
**Social Security Number**
Dutch BSN/Sofi number.
**Private Email**
Personal email address used for self-service onboarding.
Unified field: `private_email`
**Phone Numbers**
**Home Phone Number**
**Mobile Phone Number**
**Addresses**
**Home Address**
**Street**
**Number**
**Number Addition**
**Postal Code**
**City**
**Country**
ISO country code (e.g. `NL`).
**Postal Address**
The employee's mailing address, when it differs from the home address.
**Street**
**Number**
**Number Addition**
**Postal Code**
**City**
**Country**
ISO country code (e.g. `NL`).
**Employment Details**
**Start Date**
Start date of the employee. Also considered to be the hire date
Unified field: `start_date`
**Original Hire Date**
Used for CAO seniority calculations.
**End Date**
**Employee Type**
**Contract Type**
Code indicating whether the contract is for a (in)definite period.
**Probation Period End Date**
**Organization Unit**
**Job Profile**
**Hours per Week**
**Part-time Percentage**
**Payroll Client Code**
The payroll client (Opdrachtgever) code configured by the customer's Visma Raet consultant on their Youforce tenant. Whether this field is mandatory depends on the HSS workflow that handles the request – check with the customer's consultant if unsure.
**Payroll Institution Code**
The payroll company (Instelling) code configured by the customer's Visma Raet consultant on their Youforce tenant. Whether this field is mandatory depends on the HSS workflow that handles the request – check with the customer's consultant if unsure.
**Salary Details**
**Salary**
**Hourly Rate**
**Pay Scale**
**Pay Scale Step**
**Pay Scale Amount Number**
**Assignments (Inzet)**
Optional secondary deployments to other organization units. Requires a workflow configured with assignment support on the customer's tenant (e.g. "YF API - Nieuwe Medewerker (incl inzet)") – set "Workflow Name" accordingly.
**Start Date**
**End Date**
**Assignment Type**
**Organization Unit**
**Job Profile**
**Hours per Week**
**Files**
Attachments forwarded with the HSS workflow, up to roughly 28 MB total per request.
**File**
**Category**
Optional category label shown alongside the file in the HSS workflow.
**Custom Fields**
**Field Code**
Native Youforce field code, e.g. `P00390`.
**Field Value**
String-encoded value for this field.