Create a new Person and Employment.

post

https://api.personio.de/v2/persons

This endpoint enables the creation of a Person resource and an associated Employment resource.
The endpoint requires the personio:persons:write scope.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

The Person model.

string

Email of the employee. The email must be unique : 2+ employees cannot have the same email.

first_name

string

required

First name of the employee.

preferred_name

string

The preferred name of the employee, if relevant.

last_name

string

required

Last name of the employee.

gender

string | null

enum

Gender of the employee.

Allowed:

language_code

string

enum

Main language of the employee.

custom_attributes

array of objects

List of custom attributes for the employee.

custom_attributes

employments

array of objects

employments

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

201Person and Employment created successfully.

400Invalid input data.