Skip to main content
POST
/
hris
/
employees
/
form
Create employee with 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"
},
"warnings": [
{
"message": "This is an example warning!"
}
]
}
This feature is currently available for the following integrations:You’d like to see this feature for another integration? Please reach out! We’re always happy to discuss extending our coverage.
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

POST /hris/employees/form Positive response

status
string
required
Allowed value: "success"
data
object
required
Examples:
{ "id": "26vafvWSRmbhNcxJYqjCzuJg" }
warnings
object[]
required

These are the interaction warnings that are shown in the dashboard. They are meant to provide debug information to you. We recommend logging them to the console.

I