BambooHR

Read and write BambooHR employees, job and status history, time off, goals and training, with incremental change feeds and custom reports.

Keep payroll, identity, IT and finance systems aligned with the HR system of record without re-keying starters, movers and leavers.

Build a flow with BambooHR Provider API documentation

Source actions

Destination actions

Data types

Validation status

Implemented · fixture tested.

Implementation is checked against provider-shaped fixtures for every action, authentication failures, rate limits, pagination and duplicate safety. Provider sandbox and authorised account validation are recorded separately when credential-backed runs are completed.

What you can map

custom report

Run custom report
Source
Incremental
Runs an ad hoc employee report for the requested fields, optionally limited to employees changed since a timestamp.

employee changes

List changed employees
Source
Incremental
Employees inserted, updated or deleted since a timestamp, for incremental synchronisation.

employee directory

List employee directory
Source
The company directory as configured in BambooHR (fields such as display name, job title, department, location and work contact details).

employee table changes

List changed table rows
Source
Incremental
Rows of one table for every employee changed since a timestamp, for incremental history sync.

employee table rows

Add employee table row
Destination
Not retried automatically
Adds a job information, employment status, education or certification row (for example a promotion or status change).
List employee table rows
Source
Job information, employment status, education or certification history rows.
Update employee table row
Destination
Duplicate protected
Updates an existing row in one of the supported employee tables.

employees

Create employee
Destination
Not retried automatically
Adds an employee with the given name, job and contact fields.
Get employee
Source
One employee with the requested (non-sensitive) fields.
List employees
Source
Employees with names, job title and status, plus optional non-sensitive fields, using cursor pagination.
Update employee
Destination
Duplicate protected
Updates name, job, contact or address fields. Omitted fields are unchanged.

fields

List fields
Source
Standard and custom employee fields with their types, for mapping.

goals

Create employee goal
Destination
Not retried automatically
Creates a performance goal for an employee.
List employee goals
Source
Performance goals for one employee.

time off request status

Change time-off request status
Destination
Duplicate protected
Approves, denies or cancels a time-off request.

time off requests

Create time-off request
Destination
Not retried automatically
Creates a time-off request for an employee, optionally already approved.
List time-off requests
Source
Incremental
Time-off requests overlapping a date range, optionally filtered.

time off types

List time-off types
Source
Time-off types configured in BambooHR.

training records

Add training record
Destination
Not retried automatically
Records a completed training for an employee.
List employee training records
Source
Completed training records for one employee.

training types

List training types
Source
Training types configured in BambooHR.

users

List users
Source
BambooHR user accounts with their linked employee.

whos out

List who's out
Source
Approved time off and company holidays in a date range.

Authentication

BambooHR API key (HTTP Basic, password x)

Plans and access

API access is included with BambooHR Core; performance goals require Pro or Elite and training records require the Training add-on or plan. Each API key acts as the BambooHR user who created it; field and employee visibility follow that user's access level.

Test environment

Use a BambooHR trial account or a developer-portal test company; there is no shared public sandbox.

Rate limits

BambooHR throttles frequent requests without publishing a fixed quota; from 16 September 2026 throttled requests return HTTP 429 with Retry-After (previously 503).

Provider events

Global and permissioned webhooks for employee field changes and events. Nexra event triggers are not yet available; flows run on demand or on a schedule.

Before you build a flow

Pay rates, compensation, bonus, commission, national identifiers, bank details, tax, health, vaccination, ethnicity, gender and date-of-birth fields are never requested or returned, even when the API user can read them.
Table rows are limited to jobInfo, employmentStatus, employeeEducation and employeeCertifications; compensation, dependants, emergency contacts, visas and custom tables are not exposed.
Custom reports are requested in JSON only, with the same sensitive-field exclusions.
Employee files, photos, benefits and time-off balance adjustments are not implemented. Deleting employees, rows or requests is not implemented.
Creating employees, table rows, time-off requests, goals and training records has no idempotency key; uncertain writes are not repeated automatically.