Python

from kombo import SDK


with SDK(
    integration_id="workday:HWUTwvyx2wLoSUHphiWVrp28",
    api_key="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

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

    # Handle response
    print(res)

{
  "status": "success",
  "data": {
    "id": "26vafvWSRmbhNcxJYqjCzuJg"
  },
  "warnings": [
    {
      "message": "This is an example warning!"
    }
  ]
}

Unified HRIS API

Create employee with form

Create an employee, based on the form schema.

Supported integrations

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
      ]
    }
  }
}

POST

hris

employees

form

Python

from kombo import SDK


with SDK(
    integration_id="workday:HWUTwvyx2wLoSUHphiWVrp28",
    api_key="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

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

    # Handle response
    print(res)

{
  "status": "success",
  "data": {
    "id": "26vafvWSRmbhNcxJYqjCzuJg"
  },
  "warnings": [
    {
      "message": "This is an example warning!"
    }
  ]
}

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

Show child attributes

Response

POST /hris/employees/form Positive response

status

string

required

Allowed value: "success"

data

object

required

Show child attributes

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.

Show child attributes

Get employee form Update employee

⌘I

General

General

Unified HRIS API

Unified ATS API

Unified ATS (Assessment & Background Check) API

AI Apply

Kombo Connect

Custom Endpoints

API Reference

Create employee with form

Example Request Body

Authorizations

Headers

Body

Response