POST
/
hris
/
employees
curl --request POST \
  --url https://api.kombo.dev/v1/hris/employees \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Integration-Id: <x-integration-id>' \
  --data '{
  "first_name": "John",
  "last_name": "Doe",
  "work_email": "john.doe@acme.com",
  "gender": "MALE",
  "date_of_birth": "1986-01-01",
  "start_date": "2020-04-07",
  "job_title": "Integrations Team Lead",
  "home_address": {
    "city": "Berlin",
    "country": "DE",
    "state": "Berlin",
    "street_1": "Sonnenallee 63",
    "zip_code": "12045"
  }
}'
{
  "status": "success",
  "data": {
    "id": "26vafvWSRmbhNcxJYqjCzuJg",
    "remote_id": "32",
    "employee_number": "3243422",
    "first_name": "John",
    "last_name": "Doe",
    "nationality": "French",
    "display_full_name": "John Doe",
    "job_title": "Integrations Team Lead",
    "work_email": "john.doe@acme.com",
    "personal_email": "john@doe.me",
    "mobile_phone_number": "801-555-4687",
    "ssn": "555-32-6395",
    "tax_id": "12 345 678 901",
    "gender": "MALE",
    "ethnicity": "BLACK_AFRICAN_AMERICAN",
    "marital_status": "MARRIED",
    "employment_status": "INACTIVE",
    "employment_type": "FULL_TIME",
    "weekly_hours": 40,
    "avatar": "https://resources.bamboohr.com/images/photo_person_150x150.png",
    "work_location_id": "7E2gyuv6TmvtByzBxW9Sxt53",
    "legal_entity_id": "xB32bied320csBSsl3XWdlw33",
    "manager_id": "9pf2pxBB8VX8EQMC9aipW2Bo",
    "home_address": {
      "city": "Berlin",
      "country": "DE",
      "raw": "Sonnenallee 63\n12045 Berlin\nGermany",
      "state": "Berlin",
      "street_1": "Sonnenallee 63",
      "street_2": null,
      "zip_code": "12045"
    },
    "bank_accounts": [
      {
        "account_number": "1234567890",
        "bank_name": "Commerzbank",
        "bic": "COBADEFFXXX",
        "domestic_bank_routing": {
          "number": "34567890",
          "type": "DE_BANKLEITZAHL"
        },
        "holder_name": "John Doe",
        "iban": "DE12345678901234567890"
      }
    ],
    "date_of_birth": "1986-01-01T00:00:00.000Z",
    "start_date": "2020-04-07T00:00:00.000Z",
    "termination_date": "2022-05-20T00:00:00.000Z",
    "remote_created_at": "2020-04-07T12:32:01.000Z",
    "changed_at": "2022-08-07T14:01:29.196Z",
    "remote_deleted_at": null,
    "custom_fields": {},
    "integration_fields": [],
    "remote_data": null
  }
}

We are deprecating this endpoint in favor of the new create employee form endpoint.

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

Example Request Body

{
  "first_name": "John",
  "last_name": "Doe",
  "work_email": "john.doe@acme.com",
  "gender": "MALE",
  "date_of_birth": "1986-01-01",
  "start_date": "2020-04-07",
  "job_title": "Integrations Team Lead",
  "home_address": {
    "city": "Berlin",
    "country": "DE",
    "state": "Berlin",
    "street_1": "Sonnenallee 63",
    "zip_code": "12045"
  }
}

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 request body

The body is of type object.

Response

200
application/json

POST /hris/employees Successful response

The response is of type object.