Actions39
- Absence Period Actions
- Absence Type Actions
- Attendance Period Actions
- Compensation Actions
- Document Actions
- Employment Actions
- Organization Actions
- Person Actions
- Project Actions
Person → Create
AI-generatedSummary
Create a new person (employee) in Personio with required details such as email, first name, last name, language, employment status, start date, and employment type, plus optional personal and employment-related fields.
Inputs
- Email (required) — Email address for the person (employee).
- First Name (required) — First name of the person.
- Last Name (required) — Last name of the person.
- Language (required) — Preferred language code for the person (e.g., English, German).
- Employment Status (required) — The employment status of the person, like Active, Inactive, Leave, or Onboarding.
- Employment Start Date (required) — The start date of the employment in YYYY-MM-DD format.
- Employment Type (required) — Type of employment, either Internal or External.
- Additional Fields — Optional fields such as gender, preferred name, position title, supervisor ID, office ID, department ID, team ID, legal entity ID, contract end date, probation end date or length, weekly working hours, full-time benchmark hours, and cost center IDs.
- Custom Attributes — Custom attribute key-value pairs unique to the Personio instance, specified by attribute ID and value.
Output shape
a single object representing the created person including provided and generated information
The response contains the newly created person record with all submitted parameters and system-generated data. No pagination or multiple items are returned.
Examples
Example 1: Creating a new employee record
Provide email, first name, last name, language, employment status (e.g., ACTIVE), employment start date, employment type, and any additional or custom attributes required.