Skip to main content
POST
Update employee personal data
Closed Beta Feature: This endpoint is now in closed beta. Please reach out to your account manager or support.
First, get the update form. Use the returned field keys. Include required fields and any fields you want to change. Omitted fields stay unchanged; null clears a value. Error messages are written so you can show them to your users. When the HRIS refuses a value and names the field, the error message starts with the field key, so you can show it on that field. Some HRIS save a form in several steps. If a later step fails, the earlier ones stay saved, and the error says which part was saved and which part to send again. If a request times out, or fails with an error that does not say what was saved, the HRIS may still have saved the change. Check the employee in the HRIS before you send the form again.
This endpoint requires the permission Update personal data to be enabled in your scope config.

Example Request Body

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.

Path Parameters

employee_id
string
required

The Kombo ID of the employee, or its HRIS ID with a remote: prefix.

Example:

"remote:12345"

Body

application/json

POST /hris/employees/:employee_id/form/personal-data Request body

properties
object
required

Use the field keys returned by GET. Include required fields and any fields you want to change. Omitted fields stay unchanged; null clears a value.

Response

POST /hris/employees/:employee_id/form/personal-data Positive response

status
string
required
Allowed value: "success"
data
object
required
Example: