Sign in

v3

latestOpenAPI 3.1.02026-07-311255771.3 MB
Unified HRIS API

Create absence

Create a new absence.

Check this page for a detailed guide.

<Note> This endpoint requires the permission **Manage absences** to be enabled in [your scope config](/scopes). </Note>

Example Request Body

{
  "employee_id": "wXJMxwDvPAjrJ4CyqdV9",
  "absence_type_id": "3YKtQ7qedsrcCady1jSyAkY1",
  "start_date": "2019-09-17",
  "end_date": "2019-09-21",
  "start_time": "08:30:00",
  "end_time": "16:00:00",
  "start_half_day": false,
  "end_half_day": false,
  "employee_note": "Visiting the aliens"
}
post/hris/absences

Headers

X-Integration-Idstring required

ID of the integration you want to interact with.

Request body

employee_idstring required

The ID of the employee in Kombo or their ID in the remote system by prefixing it with remote: (e.g., remote:12312)

absence_type_idstring required

The ID of the absence type in Kombo (not its remote_id).

status'REQUESTED' | 'APPROVED'

The state that the absence should be created in. Some tools may approve absences automatically if they were created for an absence type that does not require approval.

start_datestring date-time required

The date that the absence starts. This is a plain date (i.e., yyyy-MM-dd), with all time information discarded.

end_datestring date-time required

When the absence ends.The date that the absence ends. This is a plain date (i.e., yyyy-MM-dd), with all time information discarded.

start_half_dayboolean

true if the absence should start in the middle of the day.

end_half_dayboolean

true if the absence should end in the middle of the day.

amountnumber double

The amount of time of the absence. Specifying this also requires specifying unit. This is supported by very few tools.

unit'HOURS' | 'DAYS'

The time unit of the amount value. Specifying this also requires specifying amount.

employee_notestring nullable required

A note describing the reason for this absence.

start_timestring

The time of when the absence begins. Follows the format HH:mm or HH:mm:ss (e.g., 14:45:15). If start_time is specified, end_time has to be specified as well.

end_timestring

The time of when the absence ends. Follows the format HH:mm or HH:mm:ss (e.g., 14:45:15). If end_time is specified, start_time has to be specified as well.

Response

POST /hris/absences Positive response

status'success' required

Example response

{
  "data": {
    "id": "22st2Ji8XpncEYEak8mvQgQF",
    "remote_id": "1348",
    "employee_id": "JDdUy9kiH5APaGizFrgNmQjM",
    "approver_id": "AgXEispYPP1BbToHpqnqcpxy",
    "start_date": "2022-08-04",
    "end_date": "2022-08-05",
    "start_half_day": true,
    "end_half_day": false,
    "start_time": "13:15:00",
    "end_time": "17:00:00",
    "amount": 2,
    "unit": "DAYS",
    "status": "APPROVED",
    "employee_note": "Visiting my family.",
    "type_id": "xzZoKssDaMZAd62kxayzzQvD",
    "remote_created_at": "2022-08-07T14:01:29.196Z",
    "remote_updated_at": "2022-08-07T14:01:29.196Z",
    "changed_at": "2022-08-07T14:01:29.196Z",
    "remote_deleted_at": "2022-08-07T14:01:29.196Z",
    "remote_data": null
  }
}