DocumentationAPI Reference
API Reference

Create Time Off History Item

put
https://{companyDomain}.bamboohr.com/api/v1/employees//time_off/history

Creates a time off history item for an employee. For used type entries, a timeOffRequestId referencing an approved request is required. For override (balance adjustment) entries via the /history path, provide the amount and timeOffTypeId directly. The eventType defaults based on the URI path when omitted.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

The ID of the employee.

Body Params
date
required

The date for the history item in YYYY-MM-DD format.

string
enum

The type of history event. Defaults to used for the /history path and override for the /balance_adjustment path when omitted.

Allowed:
integer

The ID of an approved time off request. Required when eventType is used.

integer

The ID of the time off type. Required when eventType is override.

number

The number of hours/days to record. Required when eventType is override.

string

An optional note to show in history.

Responses

401

Unauthorized. Invalid API credentials.

404

Employee not found.

503

Service unavailable due to a database error.

Updated 3 days ago

Language
Credentials
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here!

Updated 3 days ago