General
- Introduction
- Getting started
- Implementation guide
- FAQ
Features
Guides
HRIS API Reference
- Employees
- Organization
- Employee Documents
- Time off
- Time and attendance
General API Reference
- Kombo Connect
- Integrations
- Filtering
- Custom Fields
- Other
DATEV
- Getting Started
- DATEV Payroll
- DATEV Documents ( Payslips )
- DATEV eAU
- DATEV ( legacy )
Time off
Create absence
Create a new absence.
POST
/
hris
/
absences
curl --request POST \
--url https://api.kombo.dev/v1/hris/absences \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Integration-Id: <x-integration-id>' \
--data '{
"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"
}'
{
"status": "success",
"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",
"changed_at": "2022-08-07T14:01:29.196Z",
"remote_deleted_at": "2022-08-07T14:01:29.196Z",
"remote_data": null
}
}
This feature is currently available for the following integrations:
Personio
SAP SuccessFactors
Factorial
BambooHR
HiBob
Deel
Sesame HR
HR WORKS
AlexisHR
Simployer
Paycor
DATEV LODAS
DATEV Lohn & Gehalt
Kombo Sandbox
You’d like to see this feature for another integration? Please reach out! We’re always happy to discuss extending our coverage.
Check this page for a detailed guide.
This endpoint requires the permission Manage absences to be enabled in your scope config.
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"
}
Authorizations
Headers
ID of the integration you want to interact with.
Body
application/json
POST /hris/absences request body
The body is of type object
.
Response
200
application/json
POST /hris/absences Successful response
The response is of type object
.
curl --request POST \
--url https://api.kombo.dev/v1/hris/absences \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Integration-Id: <x-integration-id>' \
--data '{
"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"
}'
{
"status": "success",
"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",
"changed_at": "2022-08-07T14:01:29.196Z",
"remote_deleted_at": "2022-08-07T14:01:29.196Z",
"remote_data": null
}
}