Connect BambooHR to your AI

List Employee Break Availabilities

idrequired

The internal employee ID.

effective

The employee's local time that should be used to calculate availability.

List Employee Break Policies

idrequired

The internal employee ID.

offset

The number of items to skip before starting to collect the result set.

limit

The maximum number of items to return.

List Employees

filter

Filters used to match employees.

sort

Comma-separated list of sortable fields.

fields

Additional fields to include in each employee record beyond the default set.

page

Cursor-based pagination parameters.

Create Employee

firstNamerequired

Legal first name (required).

lastNamerequired

Legal last name (required).

workEmail

Work email address.

jobTitle

Job title.

Upload Employee File

idrequired

The internal employee ID of the employee to upload the file for.

fileNamerequired

The display name for the uploaded file.

categoryrequired

The ID of the employee file section to upload the file into.

filerequired

The file to upload.

Get Employees Directory

AcceptHeaderParameter

This endpoint can produce either JSON or XML.

onlyCurrent

When true (the default), only employees whose hire date and employment-status effective date are on or before today are returned.

Get Employee

idrequired

The internal employee ID of the employee to retrieve.

fields

Comma-separated list of fields to include in the response.

onlyCurrent

When true (the default), returns only currently effective values from historical tables (job, compensation, employment status, etc.).

AcceptHeaderParameter

This endpoint can produce either JSON or XML.

Update Employee

idrequired

The employee ID.

firstName

Legal first name.

lastName

Legal last name.

workEmail

Work email address.

Create Employee File Category

bodyrequired

The request body.

Get Employee File

idrequired

The internal employee ID of the employee whose file is being retrieved.

fileIdrequired

The ID of the employee file to download.

Update Employee File

idrequired

The internal employee ID of the employee whose file is being updated.

fileIdrequired

The ID of the employee file to update.

name

The new display name for the file.

categoryId

The ID of the file category (section) to move the file into.

Add employees to cycle

idrequired

employeeIdsrequired

Array of internal employee IDs to add to the cycle

Remove employees from cycle

idrequired

employeeIdsrequired

Array of internal employee IDs to remove from the cycle

List employee onboarding experiences

employeeIdrequired

Create employee onboarding experience

employeeIdrequired

sentDateTime

Optional sent datetime for the packet when starting the experience (string).

List Enrolled Employees

filter

OData v4 filter expression.

orderBy

Sort expression like employeeId asc, createdAt desc.

select

Comma-separated list of properties to return (sparse fieldsets).

page

The page to return.

Get Employee Enrollment

employeeIdrequired

The employee ID.

Update Employee Enrollment

employeeIdrequired

The employee ID.

enabled

True to enable time tracking for the employee, false to disable it.

configurationId

The configuration to enroll the employee in.

enabledOn

Effective date for the enable, in YYYY-MM-DD format.

Add Employees to Total Rewards

employeeIdsrequired

List of internal employee IDs to add to Total Rewards.

Remove Employees from Total Rewards

employeeIdsrequired

List of internal employee IDs to remove from Total Rewards.