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

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.personio.de/v1/company/employees' \
--data-urlencode 'employee%5Bemail%5D=' \
--data-urlencode 'employee%5Bfirst_name%5D=' \
--data-urlencode 'employee%5Blast_name%5D='

Response Example

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

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

/company/employees

/company/employees/{employee_id}