Skip to main content
POST
/
hris
/
employees
/
form
Python
from kombo import Kombo


with Kombo(
    integration_id="workday:HWUTwvyx2wLoSUHphiWVrp28",
    api_key="<YOUR_BEARER_TOKEN_HERE>",
) as k_client:

    res = k_client.hris.create_employee_with_form(properties={
        "firstName": "John",
        "startDate": "2025-01-01T00:00:00Z",
        "workLocation": {
            "site": "8e422bf8cav",
            "keyNumbers": {
                "0": 142,
                "1": 525,
                "2": 63,
            },
        },
    }, staffing_entity_id="26vafvWSRmbhNcxJYqjCzuJg")

    # Handle response
    print(res)
{
  "status": "success",
  "data": {
    "id": "26vafvWSRmbhNcxJYqjCzuJg",
    "remote_id": "12345",
    "prehire": {
      "remote_id": null
    }
  },
  "warnings": [
    {
      "message": "This is an example warning!"
    }
  ]
}
This endpoint requires the permission Create and manage employees to be enabled in your scope config.

​
Example Request Body

{
  "staffing_entity_id": "26vafvWSRmbhNcxJYqjCzuJg",
  "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
​
staffing_entity_id
string
Required string length: 24
Pattern: ^[1-9A-HJ-NP-Za-km-z]+$

Response

POST /hris/employees/form Positive response

​
status
string
required
Allowed value: "success"
​
data
object
required
Example:
{
  "id": "26vafvWSRmbhNcxJYqjCzuJg",
  "remote_id": "12345",
  "prehire": { "remote_id": null }
}
​
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.