Create an employee

POST

/company/employees

Creates new employee. Status of the employee will be set to active if hire_date provided is in past. Otherwise status will be set to onboarding. This endpoint will respond with id of created employee in case of success.

Request

Body Params application/x-www-form-urlencoded

Responses

🟢200Successful creation of a employee

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.personio.de/v1/company/employees' \
--data-urlencode 'employee[email]=' \
--data-urlencode 'employee[first_name]=' \
--data-urlencode 'employee[last_name]='

Response Example

{
    "data": {
        "id": 81723,
        "message": "success"
    },
    "success": true
}

Modified at 2023-08-22 06:28:03

/company/employees

/company/employees/{employee_id}