Skip to main content
POST
/
api
/
hris
/
v1
/
time-off
Create Time Off
curl --request POST \
  --url https://api.bindbee.dev/api/hris/v1/time-off \
  --header 'Authorization: Bearer <token>' \
  --header 'x-connector-token: <x-connector-token>'
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.bindbee.dev/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint creates a Timeoff Entry in the connected HRIS via Bindbee’s unified Time Off model.

​
Provider-specific behavior

Different HRIS systems can have slightly different requirements and behaviors when creating timeoff entries. Use the accordions below to see details for each provider.

When the underlying HRIS is ADP, a Timesheet Entry can be created using a payload like:

{
    "employee": "01929f6e-c6c1-74b4-8119-a7d9efc0c8b8",
    "amount": 8,
    "start_time": "2024-09-04T08:00:00Z",
    "end_time": "2024-09-04T16:00:00Z",
    "request_type": "VACATION"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
x-idempotency-key
string

Key to guarantee idempotent write execution.

​
x-connector-token
string
required

Response

Successful Response