POST
/
hris
/
employees
/
form
curl --request POST \
  --url https://api.kombo.dev/v1/hris/employees/form \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Integration-Id: <x-integration-id>' \
  --data '{
  "properties": {
    "firstName": "John",
    "startDate": "2025-01-01",
    "workLocation": {
      "site": "8e422bf8cav",
      "keyNumbers": [
        142,
        525,
        63
      ]
    }
  }
}'
{
  "status": "success",
  "data": {
    "id": "26vafvWSRmbhNcxJYqjCzuJg"
  }
}

This endpoint requires the permission Create and manage employees to be enabled in your scope config.

​
Example Request Body

{
  "properties": {
    "firstName": "John",
    "startDate": "2025-01-01",
    "workLocation": {
      "site": "8e422bf8cav",
      "keyNumbers": [
        142,
        525,
        63
      ]
    }
  }
}

Authorizations

​
Authorization
string
header
required

Create an API key on the Secrets page in the Kombo dashboard.

Headers

​
X-Integration-Id
string
required

ID of the integration you want to interact with.

Body

application/json
POST /hris/employees/form request body
​
properties
object
required

Response

200
application/json
POST /hris/employees/form Successful response
​
status
enum<string>
required
Available options:
success
​
data
object
required
Example:
{ "id": "26vafvWSRmbhNcxJYqjCzuJg" }