Skip to main content
POST
/
custom
/
datev
/
employees
/
{employee_id}
/
eau-requests
Create eAU Request
curl --request POST \
  --url https://api.kombo.dev/v1/custom/datev/employees/{employee_id}/eau-requests \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Integration-Id: <x-integration-id>' \
  --data '
{
  "start_work_incapacity": "2022-01-01"
}
'
{
  "status": "<string>",
  "data": {
    "eau_id": "<string>"
  },
  "warnings": [
    {
      "message": "<string>"
    }
  ]
}
This endpoint requires the permission Manage eAU to be enabled in your scope config.

​
Example Request Body

{
  "start_work_incapacity": "2022-01-01"
}

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

ID of the employee that should be updated. You can use their Kombo id or their ID in the remote system by prefixing it with remote: (e.g., remote:12312)

Body

application/json

POST /custom/datev/employees/:employee_id/eau-requests Request body

The data to request an electronic certificate of incapacity for work (eAU).

​
start_work_incapacity
string
required

Date "start_work_incapacity" from the original eAU-Request.

​
notification
object
​
contact_person
object

The data-section for the contact person which is responsible for feedback from the health insurance.

Response

POST /custom/datev/employees/:employee_id/eau-requests Positive response

​
status
string
required
Allowed value: "success"
​
data
object
required
​
warnings
object[]
required

These are the interaction warnings that are shown in the dashboard. They are meant to provide debug information to you. We recommend logging them to the console.