Unified HRIS API

Create absence

Changed on Jul 13, 2026

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

Request

Base URL
https://api.kombo.dev/v1
Auth
HTTP bearer
TypeScript
https://skmtc.dev/kombo/apis/kombo-api/docs/hris/absences/post.ts
A function with typed inputs. Its response is checked against the schema.

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
  }
}

Changes

Jul 13, 2026d0e06abf1118 Revision changes
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  the request's body type changed from no type to object
- breaking
  the response property / became optional for the status
- breaking
  response property data/status list-of-types was widened by adding types null to media type application/json of response 200
- breaking
  the / response's property type changed from string to null for status
- breaking
  the / response's property type changed from string to null, and format from date-time to no format for status
- breaking
  the / response's property type changed from string to null for status
- breaking
  the / response's property type changed from string to null, and format from date-time to no format for status
- warning
  removed subschema #1 from the request body allOf list
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  removed the non-success response with the status
- info
  removed the non-success response with the status
- info
  removed the non-success response with the status
- info
  removed the non-success response with the status
- info
  removed the non-success response with the status
- info
  the response property const value success was added for the status
- info
  removed the success enum value from the response property for the response status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property to the response with the status

Operation history