Skip to main content
POST
Update employment job
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 job 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

employment_id
string
required

The Kombo ID of the employment, or its HRIS ID with a remote: prefix. Find it in employments on the employee, or with Get employments.

Example:

"remote:67890"

Body

application/json

POST /hris/employments/:employment_id/form/job 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/employments/:employment_id/form/job Positive response

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