# BambooHR API Documentation

This is the complete API documentation for connecting to the BambooHR API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **BambooHR connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/bambooHrV2/actions/{actionSlug}/run
```

## BambooHR actions

- POST `add-time-off-request` Add Time Off Request
- PUT `change-request-status` Change Request Status
- POST `create-employee` Create Employee
- GET `get-alert-configuration` Get Alert Configuration
- GET `get-alignable-goal-options` Get Alignable Goal Options
- GET `get-benefit-coverages` Get Benefit Coverages
- GET `get-benefit-deduction-types` Get Benefit Deduction Types
- GET `get-break` Get Break
- GET `get-break-policy` Get Break Policy
- GET `get-catalog-holiday` Get Catalog Holiday
- GET `get-celebration-template-image-download-url` Get Celebration Template Image Download URL
- GET `get-change-communication-letter-details` Get Change Communication Letter Details
- GET `get-changed-employee-i-ds` Get Changed Employee I Ds
- GET `get-changed-employee-table-data` Get Changed Employee Table Data
- GET `get-changed-employees` Get Changed Employees
- GET `get-clock-entry` Get Clock Entry
- GET `get-company-benefits` Get Company Benefits
- GET `get-company-equity-settings` Get Company Equity Settings
- GET `get-company-file` Get Company File
- GET `get-company-holiday` Get Company Holiday
- GET `get-company-information` Get Company Information
- GET `get-company-profile-integrations` Get Company Profile Integrations
- GET `get-company-properties` Get Company Properties
- GET `get-compensation-benchmark-details` Get Compensation Benchmark Details
- GET `get-compensation-benchmark-export` Get Compensation Benchmark Export
- GET `get-compensation-level-group-status-counts` Get Compensation Level Group Status Counts
- GET `get-compensation-planning-approval-flows` Get Compensation Planning Approval Flows
- GET `get-compensation-planning-cycle-budgets` Get Compensation Planning Cycle Budgets
- GET `get-compensation-planning-cycle-details` Get Compensation Planning Cycle Details
- GET `get-compensation-planning-cycle-summary` Get Compensation Planning Cycle Summary
- GET `get-compensation-planning-cycle-worksheet` Get Compensation Planning Cycle Worksheet
- GET `get-compensation-planning-worksheet-csv` Get Compensation Planning Worksheet CSV
- GET `get-country-by-id` Get Country by ID
- GET `get-currency-conversion-rates` Get Currency Conversion Rates
- GET `get-custom-field` Get Custom Field
- GET `get-custom-table` Get Custom Table
- GET `get-datasets` Get Datasets
- GET `get-employee` Get Employee
- GET `get-employee-benefits` Get Employee Benefits
- GET `get-employee-dependent` Get Employee Dependent
- GET `get-employee-dependents` Get Employee Dependents
- GET `get-employee-directory` Get Employee Directory
- GET `get-employee-enrollment` Get Employee Enrollment
- GET `get-employee-file` Get Employee File
- GET `get-employee-onboarding-experience-by-id` Get Employee Onboarding Experience by ID
- GET `get-employee-photo` Get Employee Photo
- GET `get-employee-verification-integration-status` Get Employee Verification Integration Status
- GET `get-fields` Get Fields
- GET `get-fields-from-dataset` Get Fields from Dataset
- GET `get-fields-from-dataset-v12` Get Fields from Dataset V1 2
- GET `get-goal-aggregate` Get Goal Aggregate
- GET `get-goal-creation-permission` Get Goal Creation Permission
- GET `get-goal-filters-v12` Get Goal Filters V1 2
- GET `get-goals-aggregate-v12` Get Goals Aggregate V1 2
- GET `get-hour-entry` Get Hour Entry
- GET `get-job-application-details` Get Job Application Details
- GET `get-job-location` Get Job Location
- GET `get-job-titles-and-level-assignments` Get Job Titles and Level Assignments
- GET `get-legacy-report-field-map` Get Legacy Report Field Map
- GET `get-legacy-report-id-map` Get Legacy Report ID Map
- GET `get-levels-and-bands-review` Get Levels and Bands Review
- GET `get-levels-and-bands-status` Get Levels and Bands Status
- GET `get-list-field-details` Get List Field Details
- GET `get-member-benefit-events` Get Member Benefit Events
- GET `get-member-benefits` Get Member Benefits
- GET `get-new-hire-packet-by-id` Get New Hire Packet by ID
- GET `get-pay-bands` Get Pay Bands
- GET `get-printable-total-rewards-statement` Get Printable Total Rewards Statement
- GET `get-published-levels-and-bands` Get Published Levels and Bands
- GET `get-report-by-id` Get Report by ID
- GET `get-reports` Get Reports
- GET `get-schedule` Get Schedule
- GET `get-schedule-pdf` Get Schedule PDF
- GET `get-shift` Get Shift
- GET `get-tabular-fields` Get Tabular Fields
- GET `get-time-off-balance` Get Time Off Balance
- GET `get-time-off-category` Get Time Off Category
- GET `get-time-off-policies` Get Time Off Policies
- GET `get-time-off-policies-for-employee` Get Time Off Policies for Employee
- GET `get-time-off-policy` Get Time Off Policy
- GET `get-time-off-request` Get Time Off Request
- GET `get-time-off-requests` Get Time Off Requests
- GET `get-time-off-types` Get Time Off Types
- GET `get-time-tracking-configuration` Get Time Tracking Configuration
- GET `get-time-tracking-import` Get Time Tracking Import
- GET `get-time-tracking-import-row` Get Time Tracking Import Row
- GET `get-time-tracking-kiosk` Get Time Tracking Kiosk
- GET `get-time-tracking-project` Get Time Tracking Project
- GET `get-time-tracking-record` Get Time Tracking Record
- GET `get-time-tracking-shift-differential` Get Time Tracking Shift Differential
- GET `get-time-tracking-task` Get Time Tracking Task
- GET `get-time-tracking-time-clock` Get Time Tracking Time Clock
- GET `get-timesheet` Get Timesheet
- GET `get-timesheet-summary` Get Timesheet Summary
- GET `get-timezone-by-id` Get Timezone by ID
- GET `get-timezone-by-zip-code` Get Timezone by ZIP Code
- GET `get-total-rewards-profile-availability` Get Total Rewards Profile Availability
- GET `get-total-rewards-statement` Get Total Rewards Statement
- GET `get-users` Get Users
- GET `get-webhook` Get Webhook
- GET `get-welcome-new-hires-widget` Get Welcome New Hires Widget
- GET `get-whos-out` Get Who's Out
- GET `list-absent-employees` List Absent Employees
- GET `list-alert-configurations` List Alert Configurations
- GET `list-alert-templates` List Alert Templates
- GET `list-applicant-statuses` List Applicant Statuses
- GET `list-archived-custom-fields` List Archived Custom Fields
- GET `list-available-compensation-tools` List Available Compensation Tools
- GET `list-bank-holidays` List Bank Holidays
- GET `list-break-assessments` List Break Assessments
- GET `list-break-policies` List Break Policies
- GET `list-break-policy-employees` List Break Policy Employees
- GET `list-breaks-for-break-policy` List Breaks for Break Policy
- GET `list-calendar-events` List Calendar Events
- GET `list-catalog-holidays` List Catalog Holidays
- GET `list-clock-entries` List Clock Entries
- GET `list-company-files-and-categories` List Company Files and Categories
- GET `list-company-holidays` List Company Holidays
- GET `list-compensation-benchmark-sources` List Compensation Benchmark Sources
- GET `list-compensation-benchmarks` List Compensation Benchmarks
- GET `list-compensation-level-groups-and-levels` List Compensation Level Groups and Levels
- GET `list-compensation-planning-cycle-admins` List Compensation Planning Cycle Admins
- GET `list-compensation-planning-cycles` List Compensation Planning Cycles
- GET `list-countries` List Countries
- GET `list-country-provinces` List Country Provinces
- GET `list-currency-types` List Currency Types
- GET `list-custom-field-list-values` List Custom Field List Values
- GET `list-custom-field-types` List Custom Field Types
- GET `list-custom-fields` List Custom Fields
- GET `list-custom-tables` List Custom Tables
- GET `list-datasets-v12` List Datasets V1 2
- GET `list-employee-break-availabilities` List Employee Break Availabilities
- GET `list-employee-break-policies` List Employee Break Policies
- GET `list-employee-files` List Employee Files
- GET `list-employee-onboarding-experiences` List Employee Onboarding Experiences
- GET `list-employee-table-rows` List Employee Table Rows
- GET `list-employee-time-off-policies` List Employee Time Off Policies
- GET `list-employee-time-off-policies-v11` List Employee Time Off Policies V1 1
- GET `list-employee-training-records` List Employee Training Records
- GET `list-employee-verification-records-for-an-employee` List Employee Verification Records for an Employee
- GET `list-employees` List Employees
- GET `list-employees-in-compensation-planning-cycle` List Employees in Compensation Planning Cycle
- GET `list-enrolled-employees` List Enrolled Employees
- GET `list-goal-comments` List Goal Comments
- GET `list-goal-sharing-options` List Goal Sharing Options
- GET `list-goals` List Goals
- GET `list-hiring-leads` List Hiring Leads
- GET `list-hiring-locations` List Hiring Locations
- GET `list-hour-entries` List Hour Entries
- GET `list-industries` List Industries
- GET `list-job-applications` List Job Applications
- GET `list-job-locations` List Job Locations
- GET `list-job-summaries` List Job Summaries
- GET `list-job-titles-with-employees` List Job Titles with Employees
- GET `list-monitor-fields` List Monitor Fields
- GET `list-new-hire-packets` List New Hire Packets
- GET `list-open-shifts` List Open Shifts
- GET `list-provinces` List Provinces
- GET `list-schedules` List Schedules
- GET `list-scheduling-timezones` List Scheduling Timezones
- GET `list-shift-assessments` List Shift Assessments
- GET `list-shift-claims` List Shift Claims
- GET `list-shifts` List Shifts
- GET `list-time-off-policies` List Time Off Policies
- GET `list-time-off-policy-versions` List Time Off Policy Versions
- GET `list-time-off-request-comments` List Time Off Request Comments
- GET `list-time-off-requests` List Time Off Requests
- GET `list-time-tracking-configurations` List Time Tracking Configurations
- GET `list-time-tracking-import-rows` List Time Tracking Import Rows
- GET `list-time-tracking-imports` List Time Tracking Imports
- GET `list-time-tracking-kiosks` List Time Tracking Kiosks
- GET `list-time-tracking-project-tasks` List Time Tracking Project Tasks
- GET `list-time-tracking-projects` List Time Tracking Projects
- GET `list-time-tracking-shift-differentials` List Time Tracking Shift Differentials
- GET `list-time-tracking-time-clocks` List Time Tracking Time Clocks
- GET `list-timesheet-entries` List Timesheet Entries
- GET `list-timesheets` List Timesheets
- GET `list-timezones` List Timezones
- GET `list-training-categories` List Training Categories
- GET `list-training-types` List Training Types
- GET `list-webhook-logs` List Webhook Logs
- GET `list-webhook-post-fields` List Webhook Post Fields
- GET `list-webhooks` List Webhooks
- PUT `update-employee` Update Employee