---
title: "Create employee with form"
method: POST
path: "/hris/employees/form"
tags: ["Unified HRIS API"]
---

# Create employee with form

`POST /hris/employees/form`

Create an employee, based on the form schema.

<Note>
  This endpoint requires the permission **Create and manage employees** to be enabled in [your scope config](/scopes).
</Note>

### Example Request Body

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

## Headers

- `X-Integration-Id` string, required

## Request body

- PostHrisEmployeesFormRequestBody
  - `staffing_entity_id` string
  - `properties` Schema3, required

## Response `200`

POST /hris/employees/form Positive response

- PostHrisEmployeesFormPositiveResponse
  - `status` 'success', required
  - `data` object, required
    - `id` string, nullable, required — The Kombo id of the created employee. If null, we only created a pre-hire which shows up in the next sync after a successful onboarding.
    - `remote_id` string, nullable, required — The raw ID of the created employee in the remote system. This is only populated when `id` is set (i.e., when a full employee was created). For pre-hires, use the `prehire` object instead.
    - `prehire` object, required — An object containing the temporary pre-hire information from the remote system. This ID may change or become invalid when the pre-hire becomes a full employee. Only populated when `id` is null.
      - `remote_id` string, nullable, required — The temporary ID returned by the remote system when creating a pre-hire.
  - `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.
    - `message` string, required

## Other responses

- `default` — The standard error response with the error codes for the HRIS use case.

---

[API](https://skmtc.net/kombo/apis/kombo-api.md) · [All operations](https://skmtc.net/kombo/apis/kombo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kombo/kombo-api/revisions/149bf44faf1a/schema)