Personio HRIS Integration

The Personio HRIS integration allows you to sync HRIS data between Personio and your application through Kombo’s unified API. The tool slug for this connector is personio.

Guides and Resources

Connection Setup Guide

Step-by-step instructions to connect your Personio account to Kombo.

Sandbox Environment

Access the Personio sandbox environment for testing and development.

Supported Features & Coverage

Models
Actions
Features
Create Employee with Form

Legal Entities

Field	Notes
id
remote_id
changed_at
remote_deleted_at
name

Work Locations

Field	Notes
id
remote_id
changed_at
remote_deleted_at
name
type
remote_data

Employees

The employment_type is inferred from the work schedules (e.g., 40h/week -> FULL_TIME) since Personio’s API does not expose information about the employment_type otherwise. Although we have not seen any issues with this in-practice, if a Personio instance is unusually configured this may lead to issues with the correct employment_type being returned.

Field	Notes
id
remote_id
changed_at
remote_deleted_at
employee_number
first_name
last_name
nationality
display_full_name
job_title
work_email
personal_email
ssn
gender
marital_status
employment_status
employment_type
weekly_hours
avatar
work_location_id
legal_entity_id
manager_id
home_address
bank_accounts
date_of_birth
start_date
termination_date
remote_created_at
custom_fields
integration_fields
remote_data

Absence Types

Field	Notes
id
remote_id
changed_at
remote_deleted_at
name
unit
half_days_supported
exact_times_supported
remote_data

Absences

Field	Notes
id
remote_id
changed_at
remote_deleted_at
employee_id
start_date
end_date
start_half_day
end_half_day
start_time
end_time
amount
unit
status
employee_note
type_id
remote_data

Employments

Field	Notes
id
remote_id
changed_at
remote_deleted_at
employee_id
job_title
pay_rate
pay_period
pay_frequency
employment_type
pay_currency
effective_date
remote_data

Groups

Personio does not support reading all groups via one endpoint.

Field	Notes
id
remote_id
changed_at
remote_deleted_at
name
type
parent_id
remote_data

Time Off Balances

Field	Notes
id
remote_id
changed_at
remote_deleted_at
employee_id
type_id
balance
balance_unit
remote_data

Timesheets

Field	Notes
id
remote_id
changed_at
remote_deleted_at
employee_id
started_at
ended_at
timezone	We don’t receive a timezone from Personio, so we assume a default timezone of Europe/Berlin
unpaid_break_minutes
breaks
approval_status
comment
custom_fields
integration_fields
remote_data

Employee Document Categories

Field	Notes
id
remote_id
changed_at
remote_deleted_at
name
remote_data

Employee <> Group

Field	Notes
employee_id
team_id
id
changed_at
remote_deleted_at

Create absence

Input Field	Notes
employee_id
absence_type_id
status
start_date
end_date
start_half_day
end_half_day
employee_note
start_time
end_time

Delete absence

Input Field	Notes
absence_id

Create employee

Input Field	Notes
first_name
last_name
work_email
gender
job_title
home_address.street_1
home_address.city
home_address.zip_code
home_address.country
date_of_birth
start_date

Create employee (v2)

For detailed information about creating employees with form, please see the Create Employee with Form tab above.

Input Field	Notes
staffing_entity_id
properties

Add document to employee

Input Field	Notes
employee_id
category_id
document.name
document.content_type
document.data_url
document.data

Feature	Notes
API Passthrough
Webhook Subscriptions
Automatic Setup
Scope Testing
Per Model Tests
Per Field Tests
Delta Syncs
Custom Field Explorer
Employees
Connection Guide
Prerequisites
Create credentials
Group Types
TEAM
DEPARTMENT
COST_CENTER

Some optional form fields are referencing the following data models:

Employees
Groups
Locations

Consider enabling these in your scope configuration.

This form may contain additional custom fields that depend on your specific tool instance configuration. The exact custom fields available will vary based on your setup and cannot be displayed here.

text

Private Email
The private email address of the employee
Unified field: private_email

text

required

First Name
The first name of the employee
Unified field: first_name

text

required

Last Name
The last name of the employee
Unified field: last_name

text

Name (preferred)

single_select

Gender
The gender of the employee
Unified field: gender

single_select

Language
Main language of the employee.

object

Employment
Employment of the employee.

Show properties

single_select

Supervisor
The supervisor of the employee.
References /v1/hris/employees?remote_model=employee

single_select

Office
The office of the employee.
Unified field: location_id
References /v1/hris/locations?remote_model=location

object

Org Units
All Org Units, i.e. department and team, that are to be associated with the Employment.

Show properties

single_select

Department
The department of the employee.
References /v1/hris/groups?types=DEPARTMENT

single_select

Team
The team of the employee.
References /v1/hris/groups?types=TEAM

single_select

Legal Entity
The legal entity of the employee.

text

Position - Title
The title of the position.

date

Start Date
Start date of the employee. Also considered to be the hire date
Unified field: start_date

single_select

Type
The type of the employment.

date

Contract End Date
The end date of the contract.

number

Probation Period Length
The length of the probation period in months.

number

Weekly Working Hours
The number of hours the employee works per week.

number

Full-Time Weekly Working Hours
The number of hours per week that is considered full time for the employment.

array

Cost Centers
The weight distribution of this employment between different cost centers, using percentages.

Show items

single_select

required

Cost Center Name
References /v1/hris/groups?types=COST_CENTER

number

required

Weight
The weight in percentage assigned to this Cost Center. The total of all Cost Center weights must be 100.

object

Custom Attributes

Show properties

This object may contain additional custom fields that depend on your specific tool instance configuration. The exact custom fields available will vary based on your setup and cannot be displayed here.

Integration Variants

Current connector: Personio For Personio, we also offer the following other connector variants:

Personio ATS

Personio for the ATS category

General

Features

Guides

HRIS API Reference

Payroll API Reference

General API Reference

DATEV

Personio HRIS Integration

Guides and Resources

Connection Setup Guide

Sandbox Environment

Supported Features & Coverage

Integration Variants

Personio ATS

​Guides and Resources

Connection Setup Guide

Sandbox Environment

​Supported Features & Coverage

​Integration Variants

Personio ATS

Guides and Resources

Supported Features & Coverage

Integration Variants