BambooHR connector icon

BambooHR Connector

Build in‑app BambooHR integrations that sync employee records, onboard hires, manage time off and time tracking, exchange employee files and run scheduled reports. Publish these workflows inside your product to automate HR processes for every customer account.

01

Faster integration delivery

Ship BambooHR workflows without building each connector from scratch.

02

Reusable orchestration

Author one workflow and reuse it for every customer environment.

03

Tenant governance

Keep customer credentials isolated and enforce access controls centrally.

04

Embedded experience

Deliver customer-facing workflows natively inside your SaaS product.

CONNECTOR OVERVIEW

What you can integrate and automate with BambooHR

Teams can integrate BambooHR employee records, time‑off and time‑tracking data, reports and employee files to automate hiring, onboarding, offboarding, payroll exports and compliance reporting. Use Cyclr’s low‑code builder to map employee fields, call report endpoints and subscribe to BambooHR webhooks so workflows run automatically for each tenant.

PRODUCT USE CASES

Use cases — what teams typically build

Create customer‑facing automations that provision accounts, sync directories, trigger onboarding sequences and route time‑off or payroll data. Combine BambooHR reads, writes and webhooks into governed workflows you can embed and manage across many customer accounts.

Automated new-hire provisioning

When a hire is created in BambooHR, create user accounts and provision apps; uses employee.created webhook and employee record reads.

Keep SaaS user directory in sync

Regularly sync BambooHR employee directory to your app user list using employees/directory and scheduled report calls.

Automate time‑off and approvals

Subscribe to time‑off and employee.updated events, push approvals to calendar and downstream payroll systems.

ORCHESTRATION

How BambooHR works with Cyclr

Cyclr sits between your SaaS product and BambooHR to handle authentication, govern access and orchestrate every API call per customer, at scale.

  1. 1

    Your SaaS product

    Your app requests an action for a specific customer.

  2. 2

    Cyclr orchestration

    Cyclr authenticates, applies policies and routes the request.

  3. 3

    BambooHR

    BambooHR processes the request and returns a response to your app.

Customer-specific authentication · Governed data movement · Centralized visibility and audit

CONNECTOR COVERAGE

Available connector capabilities

Explore BambooHR methods you can orchestrate through Cyclr.

Hours5

Get Hour Record

Action

Get details of an Hour Record by ID.

Bulk Create / Update Hour Records

Action

Bulk Create and / or Update Hour Records.

Delete Hour Record

Action

Delete an Hour Record by ID.

Update Hour Record

Action

Update an Hour Record by ID.

Create Hour Record

Action

Create an Hour Record.

Account Information6

List Users

Action

Lists all users.

List Manageable List-Fields

Action

List all manageable list fields.

Upsert List-Field Values

Action

Add or update values for a list field.

List List-Fields

Action

List all List Fields.

List Tabular Fields

Action

List all tabular fields.

List Account Fields

Action

List all account fields.

Employees14

List Employees

Action

Lists all employees.

Get Employee By Email

Action

Get an employee using the specified email address.

List Employee Changes

Action

Lists all employees changes since the last run date.

Update Employee

Action

Updates information about the specified employee.

List Deleted Employees

Action

Lists all deleted employees.

List Updated Employees

Action

Lists all employees updated since the last run date.

Create Employee

Action

Create a new Employee.

Get Employee

Action

Retrieves information about the specified employee.

List New Employees

Action

Lists all employees created since the last run date.

Get Employee Dependent

Action

Retrieves an Employee Dependent.

Update Employee Dependent

Action

Update an employee dependent.

List Employee Dependents

Action

Liss all employees dependents.

List Benefit Deduction Types

Action

Lists all Benefit Deduction Types.

Create Employee Dependent

Action

Create an Employee Dependent.

Applicant Tracking12

List Applications

Action

List all applications.

Create New Candidate

Action

Create a new candidate.

List New Job Summaries

Action

List all job summaries created since the last run.

List Hiring Leads

Action

List all hiring leads.

List Statuses

Action

List all statuses.

List New Applications

Action

List all applications created since the last run.

Update Applicant Status

Action

Change applicant's status.

List Job Summaries

Action

List all job summaries.

Create Job Opening

Action

Add a new job opening.

Get Application Details

Action

Get an application details by the given application ID.

Create Application Comment

Action

Add a Comment to an Application.

List Company Locations

Action

List all company locations.

Goals19

List Goal Status Counts

Action

Lists counts for all goals per status for an employee.

Can Create a Goal

Action

Determine if the API user has permission to create a goal for this employee.

List Aggregate Goal Information

Action

Llist all goals for the specified employee.

List Alignable Goal Options

Action

List all alignable goal options for an employee.

List Goals

Action

List all goals for an employee.

Reopen a Goal

Action

Reopen a goal.

Close Goal

Action

Close a goal.

Delete Goal

Action

Delete a goal.

Update Goal Sharing

Action

Updates which employees this goal is shared with.

List Goal Status Counts (Version 1.1)

Action

Lists counts for all goals per status for an employee.

Create Goal

Action

Create a new goal for an employee.

Update Goal Progress

Action

Updates progress of a goal.

Update Goal

Action

Update a goal.

List Available Goal Sharing Options

Action

Lists all employees with whom the specified employee's goals may be shared.

Get Aggregate Goal Information

Action

Returns goal information, goal comments, and employees shared with goals or who have commented on the given goal.

Delete Goal Comment

Action

Delete a goal comment.

Create Goal Comment

Action

Create a new goal comment.

Update Goal Comment

Action

Update a goal comment.

List Goal Comments

Action

List comments for the speicifed goal.

Payroll4

List Direct Deposit Accounts

Action

Lists employee's direct deposit information.

Get Paystub

Action

Retrieves an employee's paystub.

List Default Withholdings

Action

Lists employee's default withholdings.

List Unpaid Paystubs

Action

Lists employee's unpaid paystubs.

Reports2

Get Company Report

Action

Get a company report.

Create Custom Report

Action

Create a custom report.

Photos2

Get Employee Photo

Action

Returns the binary data for the employee photo.

Upload Employee Photo

Action

Upload an employee photo to an employee record.

Training12

Create Training Category

Action

Add a Training Category.

Delete Training Category

Action

Delete an existing Training Category.

List Employee Trainings

Action

Lists all employee training records.

Delete Training Type

Action

Delete an existing Training Type.

Delete Employee Training Record

Action

Delete an existing Employee Training record.

Update Employee Training Record

Action

Update an existing employee training record.

Create Training Type

Action

Add a Training type.

Update Training Category

Action

Update an existing Training Category.

List Training Types

Action

Lists all training types.

Create Employee Training Record

Action

Add a new employee training record.

List Training Categories

Action

Lists all training categories.

Update Training Type

Action

Update an existing Training Type.

Employee Files6

Update Employee File

Action

Update an employee file.

Delete Employee File

Action

Delete an employee file.

Get Employee File

Action

Get an employee file.

Upload Employee File

Action

Upload an employee file.

Create Employee File Categories

Action

Create employee file categories.

List Employee Files And Categories

Action

Lists all employee files and categories.

Time Off13

Estimate Future Time Off Balances

Action

Sum future time off accruals, scheduled time off, and carry-over events to produce estimates for the anticipated time off balance on a given date in the future.

List Time Off Policies

Action

List Time Off policies.

List Time Off Types

Action

List Time Off types.

List Time Off Requests

Action

List all time off requests.

List Time Off Balances

Action

List all time off balances.

List Employees Taking Time Off

Action

List all employees currently taking time off.

Create Time Off History Item For Time Off Request

Action

A new Time Off History Item will be inserted into the database.

Update Request Status

Action

Change the status of a Request in the system. You can use this to approve, deny, or cancel a time off request.

Assign Time Off Policies For Employee

Action

Assign Time Off Policies for an Employee.

List Time Off Policies For Employee

Action

List Time Off Policies for an Employee.

Create Time Off Request

Action

Creates a new time off request.

Update Time Off Balance

Action

A Time Off Balance adjustment will be inserted into the database.

List Updated Time Off Requests

Action

List all time off requests updated since the last run.

Webhooks1

Employee Updated

Webhook

Webhook that is fired when an employee record is updated in BambooHR.

TECHNICAL DETAILS

BambooHR integration and API details

Review the sourced authentication and API behaviour used when configuring customer-facing BambooHR integrations in Cyclr.

API and authentication

API host
https://{companySubdomain}.bamboohr.com/api/
Authentication
API key (Basic auth) or OAuth 2.0
Credentials

Company subdomain plus either API key or OAuth client ID, client secret and redirect URI.

Method categories

Employees, Time Off, Time Tracking, Reports, Employee Files, Hiring, Webhooks, Custom Reports.

View vendor API documentation →

Pagination and rate limits

Pagination

Many list endpoints use offset and limit paging; default limit 100 and maximum 500. Page until a page returns fewer rows.

Rate limits

BambooHR may throttle heavy traffic; 429 or 503 responses possible. Use exponential backoff and honor Retry‑After headers when provided.

IMPLEMENTATION

Authentication at a glance

Supports API key via HTTP Basic auth and OAuth 2.0 for third‑party/partner apps; requests are scoped by user permissions.

Authentication method
API key (Basic auth) or OAuth 2.0
Credential required

Company subdomain plus either API key or OAuth client ID, client secret and redirect URI.

Before you begin:

API keys are user‑scoped; third‑party partner integrations should use OAuth and follow BambooHR developer terms.

View setup guide

COMMON QUESTIONS

Frequently asked questions

It syncs employee records, time‑off and time‑tracking data, employee files and reports to automate hiring, onboarding, offboarding, payroll exports and compliance workflows.

Use an API key with HTTP Basic auth for user‑scoped access or register an OAuth 2.0 app for third‑party/partner integrations; requests inherit the API user’s permissions.

Yes. Cyclr supports tenant-aware connections so you can store per‑customer BambooHR credentials and run isolated workflows for each account.

Yes. You can expose vetted BambooHR reads, writes and webhook triggers as governed MCP tools inside Cyclr, enforcing access controls and reuse across tenants.