Integration · Payroll & HR

Connect Claude & ChatGPT to BambooHR

Ask your AI who is out next week, how many vacation days an employee has left, or to run a saved report in BambooHR. It can read employee records and the directory, handle time off requests, clock people in and out, and query datasets for a report built on the spot. You decide which tools are on, so pay data and approvals stay off until you want them.

Connect BambooHR free

Free plan, no credit card. Takes about a minute.

Try asking

“Who is out between 6 and 10 October?”
The AI lists everyone who is out in that period, with time off and company holidays.
“How many vacation days does employee 214 have left?”
It reads the employee's time off balances per type, as of today or a future date you give it.
“Approve Maria's pending time off request and add a note.”
It finds the pending request and approves it with your manager note. BambooHR notifies Maria.

What your AI can do

Employees and directory

Read the employee directory, employee records, history tables and documents, and create or update employees.

Time off and time tracking

See who is out, read balances, create, approve, deny or cancel time off requests, and clock employees in and out.

Reports and datasets

Run saved custom reports or query datasets with your own fields, filters and sorting.

“Run our saved headcount report.”
It finds the report among your saved custom reports and returns its rows.
“List everyone in Sales hired after January 2025.”
It queries the employee dataset with filters on department and hire date and returns the fields you ask for.
“Add Jonas Berg as Account Manager in Sales, starting 1 November.”
It creates the employee with name, job title, department and hire date.

360 tools for BambooHR

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

add_custom_field_list_valueChanges dataList custom fields. API summary: Add Custom Field List Value.
add_employees_to_total_rewardsChanges dataCreate a new employee. Required: employee ids. Search employees first to avoid duplicates. API summary: Add Employees to Total Rewards.
approve_time_off_requestChanges dataApprove a pending time off request. Required: request_id. Optional: manager_note. The employee is notified.
approve_timesheet_approvalVisible to othersApprove a timesheet approval. Has effects visible outside this system. API summary: Approve Timesheet.
archive_custom_fieldDeletesArchive a custom field (custom field id). Destructive action; may require approval. API summary: Archive Custom Field.
assign_employees_to_break_policyChanges dataAssign a break policy (break policy id). API summary: Assign Employees to Break Policy.
attach_break_policyChanges dataAssign a break policy (break policy id). API summary: Set Employees for Break Policy.
attach_employeeChanges dataAttach a employee (employee id). API summary: Assign Employee Time Off Policy.
cancel_new_hire_packetDeletesCancel a new hire packet (new hire packet id). Destructive action; may require approval. API summary: Cancel new hire packet.
cancel_time_off_requestChanges dataCancel a time off request. Required: request_id.
clock_in_employeeChanges dataClock an employee in for time tracking. Required: employee_id. Optional: date, start, timezone, project_id, task_id, note.
clock_out_employeeChanges dataClock an employee out. Required: employee_id. Optional: date, end, timezone.
create_addChanges dataCreate a new add. Required: time tracking id, employee id, date hours worked, rate type or hours worked. API summary: Create Hour Record.
create_addressChanges dataCreate a new address. Required: label or address. Search addresses first to avoid duplicates. API summary: Create a job location.
create_alert_configurationChanges dataCreate a new alert configuration. Required: bamboo alert id. API summary: Create Alert Configuration.
create_applicationChanges dataCreate a new application. Required: first name, last name or job id. Search applications first to avoid duplicates. API summary: Create Candidate.
create_application_messageChanges dataCreate a new message for a application. Required: comment. API summary: Create Job Application Comment.
create_benchmarkChanges dataCreate a new benchmark. Required: job title id, currency code, benchmark value, benchmark min or benchmark max. API summary: Create Compensation Benchmark.
create_break_policyChanges dataCreate a new break policy. Required: name. Search break policies first to avoid duplicates. API summary: Create Break Policy.
create_break_policy_breakChanges dataCreate a new break for a break policy. Search breaks first to avoid duplicates. API summary: Create Break.
create_categoryChanges dataCreate a new category. Required: name or unit. API summary: Create Time Off Category.
create_clock_inChanges dataCreate a new clock in. Required: employee id or timezone.
create_clock_outChanges dataCreate a new clock out. Required: employee id.
create_companyChanges dataCreate a new company. Required: audience. Search companies first to avoid duplicates. API summary: Create Company Holiday.
create_company_bulk_insert_company_holidaysVisible to othersCreate a new company. Required: items. Search companies first to avoid duplicates. Has effects visible outside this system. API summary: Bulk Create Company Holidays.
create_company_file_categoryChanges dataCreate a new category. Required: items. API summary: Create Company File Category.
create_configurationChanges dataCreate a new configuration. Required: name, timesheet type, work week starts on, approver type, approval cutoff or approval cutoff days. Search configurations first to avoid duplicates. API summary: Create Configuration.
create_custom_fieldChanges dataCreate a new custom field. API summary: Create Custom Field.
create_custom_tableChanges dataCreate a new custom table. Required: name, type, tab or columns. API summary: Create Custom Table.
create_custom_table_fieldChanges dataCreate a new field for a custom table. Required: name or type. API summary: Create Custom Table Field.
create_dataset_field_optionChanges dataCreate a new field option for a dataset. Required: fields. API summary: Get Field Options (v1.2).
create_employeeChanges dataAdd a new employee. Required: first_name and last_name. Optional: hire_date, job_title, department, work_email.
create_employee_bulk_upsert_time_tracking_employee_enrollmentsVisible to othersCreate a new employee. Required: items. Search employees first to avoid duplicates. Has effects visible outside this system. API summary: Bulk Upsert Employee Enrollments.
create_employee_create_employeeChanges dataCreate a new employee. Required: first name or last name. Search employees first to avoid duplicates. API summary: Create Employee.
create_employee_dependentChanges dataCreate a new employee. Required: employee id. Search employees first to avoid duplicates. API summary: Create Employee Dependent.
create_employee_file_categoryChanges dataCreate a new category. Required: items. API summary: Create Employee File Category.
create_employee_goalChanges dataCreate a new goal for a employee. Required: title, due date or shared with employee ids. Search goals first to avoid duplicates. API summary: Create Goal.
create_employee_onboarding_experienceChanges dataCreate a new onboarding experience for a employee. API summary: Create employee onboarding experience.
create_employee_training_recordChanges dataUpdate an existing employee identified by employee id. API summary: Create Employee Training Record.
create_goal_messageChanges dataCreate a new message for a goal. Required: text. API summary: Create Goal Comment.
create_hire_packetChanges dataCreate a new hire packet. Results are paginated. API summary: List new hire packets.
create_hour_entryChanges dataCreate a new page. Required: employee id, date or hours. Search pages first to avoid duplicates. API summary: Create Hour Entry.
create_import_executeChanges dataCreate a new execute for a import. API summary: Execute Time Tracking Import.
create_job_openingChanges dataCreate a new job opening. Required: posting title, job status, hiring lead, employment type or job description. API summary: Create Job Opening.
create_new_hire_packetChanges dataCreate a new hire packet. Required: employee id. API summary: Create new hire packet.
create_onboarding_hire_widgetChanges dataCreate a new onboarding. API summary: Get welcome new hires widget.
create_or_update_timesheet_hour_entriesChanges dataCreate a new store. Required: hours. API summary: Create or Update Timesheet Hour Entries.
create_pageChanges dataCreate a new page. Required: employee id, start, end or timezone. Search pages first to avoid duplicates. API summary: Create Clock Entry.
create_planning_cycleChanges dataCreate a new planning cycle. API summary: Create compensation planning cycle.
create_planning_cycle_adminChanges dataCreate a new admin for a planning cycle. Required: employee ids. API summary: Add cycle admins.
create_planning_cycle_employeeChanges dataCreate a new employee for a planning cycle. Required: employee ids. Search employees first to avoid duplicates. API summary: Add employees to cycle.
create_planning_cycle_recommendationChanges dataCreate a new recommendation for a planning cycle. Required: employee id, assignee employee id or approval stage. API summary: Save recommendations.
create_projectChanges dataCreate a new project. Required: name. Search projects first to avoid duplicates. API summary: Create Time Tracking Project.
create_project_taskChanges dataCreate a new task for a project. Required: name. Search tasks first to avoid duplicates. API summary: Create Time Tracking Project Task.
create_recordChanges dataCreate a new record. Required: items. API summary: Create or Update Hour Records.
create_requestChanges dataCreate a new request. Required: employee id, category id, start date or end date. Search requests first to avoid duplicates. API summary: Create Time Off Request.
create_request_messageChanges dataCreate a new message for a request. Required: comment. API summary: Create Time Off Request Comment.
create_scheduleChanges dataCreate a new schedule. Required: name, location id or start of week. Search schedules first to avoid duplicates. API summary: Create Schedule.
create_shiftChanges dataCreate a new shift. Required: schedule id, status, color, timezone, start or end. API summary: Create Shift.
create_shift_differentialChanges dataCreate a new shift differential. Required: name, rate, rate type or times. Search shift differentials first to avoid duplicates. API summary: Create Time Tracking Shift Differential.
create_sourceChanges dataCreate a new source. Required: name. API summary: Create Compensation Benchmark Source.
create_storeChanges dataCreate a new store. Required: entries. API summary: Create or Update Timesheet Clock Entries.
create_suggestionChanges dataCreate a new suggestion. Required: prompt. API summary: Get Break Policy Suggestions.
create_table_row_v1_1Changes dataUpdate an existing table identified by table. API summary: Create Table Row (v1.1).
create_time_off_requestVisible to othersCreate a time off request for an employee. Required: employee_id, time_off_type_id (from list_time_off_types), start and end (YYYY-MM-DD) and status (requested, or approved to record it as already approved). Optional: amount, notes.
create_training_categoryChanges dataCreate a new category. Required: name. API summary: Create Training Category.
create_typeChanges dataCreate a new type. Required: name. API summary: Create Training Type.
create_webhookDeletesCreate a new webhook. Required: name, url or format. Destructive action; may require approval. API summary: Create Webhook.
create_webhook_fieldsChanges dataCreate a new webhook. API summary: Get Webhook Post Fields.
delete_addressDeletesPermanently delete a address by address id. Destructive action; may require approval. API summary: Delete a job location.
delete_benchmarkDeletesPermanently delete a benchmark by benchmark id. Destructive action; may require approval. API summary: Delete Compensation Benchmark.
delete_breakDeletesPermanently delete a break by break id. Destructive action; may require approval. API summary: Delete Break.
delete_break_policyDeletesPermanently delete a break policy by break policy id. Destructive action; may require approval. API summary: Delete Break Policy.
delete_categoryDeletesPermanently delete a category by category id. Destructive action; may require approval. API summary: Delete Time Off Category.
delete_companyDeletesPermanently delete a company by company id. Destructive action; may require approval. API summary: Delete Company Holiday.
delete_configurationDeletesPermanently delete a configuration by configuration id. Destructive action; may require approval. API summary: Delete Configuration.
delete_custom_disclaimersMoves moneyPermanently delete a custom disclaimer. Financial or irreversible action; may require approval. API summary: Remove Total Rewards Custom Disclaimer.
delete_custom_field_list_valueDeletesPermanently delete a list value by list value id. Destructive action; may require approval. API summary: Delete Custom Field List Value.
delete_custom_table_fieldDeletesPermanently delete a field by field id. Destructive action; may require approval. API summary: Delete Custom Table Field.
delete_deleteDeletesPermanently delete a delete by delete id. Destructive action; may require approval. API summary: Delete Hour Record.
delete_deletesDeletesPermanently delete a delete. Destructive action; may require approval. API summary: Delete Timesheet Clock Entries.
delete_documentDeletesPermanently delete a document by document id. Destructive action; may require approval. API summary: Delete Company File.
delete_employeeDeletesPermanently delete a employee by employee id. Destructive action; may require approval. API summary: Remove from approval flow.
delete_employee_delete_employeeDeletesPermanently delete a employee by employee id. Destructive action; may require approval. API summary: Delete employee.
delete_employee_documentDeletesPermanently delete a document by document id. Destructive action; may require approval. API summary: Delete Employee File.
delete_employee_goalDeletesPermanently delete a goal by goal id. Destructive action; may require approval. API summary: Delete Goal.
delete_employee_tableDeletesPermanently delete a table by row id. Destructive action; may require approval. API summary: Delete Employee Table Row.
delete_employeesMoves moneyPermanently delete a employee. Financial or irreversible action; may require approval. API summary: Remove Employees from Total Rewards.
delete_goal_messageDeletesPermanently delete a message by message id. Destructive action; may require approval. API summary: Delete Goal Comment.
delete_hour_entryDeletesPermanently delete a page by page id. Destructive action; may require approval. API summary: Delete Hour Entry.
delete_importDeletesPermanently delete a import by import id. Destructive action; may require approval. API summary: Delete Time Tracking Import.
delete_kioskDeletesPermanently delete a kiosk by kiosk id. Destructive action; may require approval. API summary: Delete Time Tracking Kiosk.
delete_levelMoves moneyPermanently delete a level by segment. Financial or irreversible action; may require approval. API summary: Delete Compensation Level Groups or Level.
delete_new_hire_packetDeletesPermanently delete a new hire packet by new hire packet id. Destructive action; may require approval. API summary: Delete new hire packet.
delete_pageDeletesPermanently delete a page by page id. Destructive action; may require approval. API summary: Delete Clock Entry.
delete_planning_cycleDeletesPermanently delete a planning cycle by planning cycle id. Destructive action; may require approval. API summary: Delete compensation planning cycle.
delete_planning_cycle_adminDeletesPermanently delete a admin by employee id. Destructive action; may require approval. API summary: Remove cycle admin.
delete_planning_cycle_employeesMoves moneyPermanently delete a employee by planning cycle id. Financial or irreversible action; may require approval. API summary: Remove employees from cycle.
delete_projectDeletesPermanently delete a project by project id. Destructive action; may require approval. API summary: Delete Time Tracking Project.
delete_recordDeletesPermanently delete a record by employee training record id. Destructive action; may require approval. API summary: Delete Employee Training Record.
delete_scheduleDeletesPermanently delete a schedule by schedule id. Destructive action; may require approval. API summary: Delete Schedule.
delete_shiftDeletesPermanently delete a shift by shift id. Destructive action; may require approval. API summary: Delete Shift.
delete_shift_differentialDeletesPermanently delete a shift differential by shift differential id. Destructive action; may require approval. API summary: Delete Time Tracking Shift Differential.
delete_sourcesMoves moneyPermanently delete a source. Financial or irreversible action; may require approval. API summary: Delete Compensation Benchmark Source.
delete_taskDeletesPermanently delete a task by task id. Destructive action; may require approval. API summary: Delete Time Tracking Task.
delete_time_off_policyDeletesPermanently delete a employee by employee id. Destructive action; may require approval. API summary: Delete Time Off Policy.
delete_timesheet_hour_entriesDeletesPermanently delete a delete. Destructive action; may require approval. API summary: Delete Timesheet Hour Entries.
delete_training_categoryDeletesPermanently delete a category by training category id. Destructive action; may require approval. API summary: Delete Training Category.
delete_typeDeletesPermanently delete a type by training type id. Destructive action; may require approval. API summary: Delete Training Type.
delete_webhookDeletesPermanently delete a webhook by webhook id. Destructive action; may require approval. API summary: Delete Webhook.
deny_time_off_requestChanges dataDeny a pending time off request. Required: request_id. Optional: manager_note. The employee is notified.
detach_break_policyChanges dataUnassign a break policy (break policy id). API summary: Unassign Employees from Break Policy.
detach_employeeDeletesDetach a employee (assignment id). Destructive action; may require approval. API summary: Unassign Employee Time Off Policy.
download_schedule_pdfDownload the pdf document for a schedule. API summary: Get Schedule PDF.
export_detailsExport details. API summary: Export Compensation Benchmark Details.
export_worksheetsExport worksheets. API summary: Export compensation planning cycle worksheet to CSV.
get_addressGet one address by address id. API summary: Get a job location.
get_alert_configurationGet one alert configuration by alert configuration id. API summary: Get Alert Configuration.
get_all_currency_typesList types. API summary: Get all currency types.
get_applicationGet one application by application id. API summary: Get Job Application Details.
get_application_statusChanges dataGet the current status of a application by application id. API summary: Update Applicant Status.
get_breakGet one break by break id. API summary: Get Break.
get_break_policyGet one break policy by break policy id. API summary: Get Break Policy.
get_by_zipGet one by zip by zip. API summary: Get timezone by ZIP code.
get_catalogGet one catalog by catalog uuid. API summary: Get Catalog Holiday.
get_categoryGet one category by category id. API summary: Get Time Off Category.
get_companyGet one company by company id. API summary: Get Company Holiday.
get_company_informationGet the company's name, address and contact information.
get_configurationGet one configuration by configuration id. API summary: Get Configuration.
get_countryGet one country by country id. API summary: Get Country by ID.
get_custom_fieldGet one custom field by custom field id. API summary: Get Custom Field.
get_custom_tableGet one custom table by custom table id. API summary: Get Custom Table.
get_documentGet one document by document id. API summary: Get Company File.
get_employeeGet one employee's record. Required: employee_id.
get_employee_2Get one employee by employee id. API summary: List employee verification records for an employee.
get_employee_dependentGet one employee by employee id. API summary: Get Employee Dependent.
get_employee_directoryGet the company employee directory: names, job titles, departments, locations and work contact details.
get_employee_documentGet one document for a employee by document id. API summary: Get Employee File.
get_employee_enrollmentGet one employee by employee id. API summary: Get Employee Enrollment.
get_employee_onboarding_experienceGet one onboarding experience for a employee by onboarding experience id. API summary: Get employee onboarding experience by id.
get_employee_photoGet one photo for a employee by size. API summary: Get Employee Photo.
get_employee_tableGet rows from an employee's history table, such as jobInfo, employmentStatus or compensation. Required: employee_id and table.
get_hour_entryGet one page by page id. API summary: Get Hour Entry.
get_importGet one import by import id. API summary: Get Time Tracking Import.
get_import_rowGet one row for a import by row id. API summary: Get Time Tracking Import Row.
get_kioskGet one kiosk by kiosk id. API summary: Get Time Tracking Kiosk.
get_new_hire_packetGet one new hire packet by new hire packet id. API summary: Get new hire packet by id.
get_pageGet one page by page id. API summary: Get Clock Entry.
get_pay_grades_and_band_statusGet the current status of a pay grades and band. API summary: Get Levels and Bands Status.
get_pay_grades_and_band_status_countsGet the current status of a pay grades and band. API summary: Get Compensation Level Group Status Counts.
get_planning_cycleGet one planning cycle by planning cycle id. API summary: Get compensation planning cycle details.
get_projectGet one project by project id. API summary: Get Time Tracking Project.
get_provinceGet one province by country id. API summary: List states and provinces for a country by Country ID.
get_recordGet one record by record id. API summary: Get Time Tracking Record.
get_scheduleGet one schedule by schedule id. API summary: Get Schedule.
get_shiftGet one shift by shift id. API summary: Get Shift.
get_shift_differentialGet one shift differential by shift differential id. API summary: Get Time Tracking Shift Differential.
get_tableGet one table by table. API summary: Get Changed Employee Table Data.
get_taskGet one task by task id. API summary: Get Time Tracking Task.
get_time_clockGet one time clock by time clock id. API summary: Get Time Tracking Time Clock.
get_time_off_balancesGet an employee's time off balances per type, as of today or a future date (end). Required: employee_id.
get_time_off_policyGet one employee by employee id. API summary: Get Time Off Policy.
get_time_off_requestGet one time off request with dates, type, amount, status and notes. Required: request_id.
get_timesheetGet one timesheet by timesheet id. API summary: Get Timesheet.
get_timezoneGet one timezone by timezone id. API summary: Get timezone by ID.
get_total_rewardGet one total reward by employee id. API summary: Check Total Rewards Profile Availability.
get_webhookGet one webhook by webhook id. API summary: Get Webhook.
list_addressesList addresses. API summary: Get Company Locations.
list_alert_configurationsList alert configurations.
list_alertsList alerts. API summary: List Alert Templates.
list_alignment_optionsList alignment options. Optional filters: goal id. API summary: Get Alignable Goal Options.
list_allsList alls. API summary: List Benefit Deduction Types.
list_archivedsList archiveds. Results are paginated. API summary: List Archived Custom Fields.
list_bank_holidaysList bank holidays. Optional filters: year.
list_benchmarksList benchmarks. API summary: List Compensation Benchmarks.
list_benefitcoveragesList benefitcoverages. API summary: List Benefit Coverages.
list_break_policy_employeesList employees for a break policy. Results are paginated. API summary: List Break Policy Employees.
list_can_create_goalsList can create goals. API summary: Get Goal Creation Permission.
list_categoriesList categories. API summary: List Training Categories.
list_changedsList changeds. Optional filters: since or type. API summary: Get Changed Employee IDs.
list_clock_entriesList time tracking clock entries. Narrow with filter (e.g. by employee or date).
list_companiesList companies. API summary: Get company properties.
list_company_benefitsList company benefits.
list_company_profile_integrationsList company profile integrations. API summary: Get Company Profile Integrations.
list_currency_conversionsList currency conversions. Optional filters: base currency. API summary: Get Currency Conversion Rates.
list_custom_fieldsList custom fields. Results are paginated.
list_custom_fields_valuesList custom fields. API summary: List Custom Field List Values.
list_custom_tablesList custom tables. Results are paginated.
list_dataset_fieldsList the fields you can select and filter on in a dataset. Required: dataset_name.
list_datasetsList the datasets available for querying (e.g. employee data).
list_detailsList details. Optional filters: job id or location id. API summary: Get Compensation Benchmark Details.
list_employee_break_availabilitiesList break availabilities for a employee. Optional filters: effective. API summary: List Employee Break Availabilities.
list_employee_break_policiesList break policies for a employee. Results are paginated. API summary: List Employee Break Policies.
list_employee_dependentsList employees. Optional filters: employeeid. API summary: List Employee Dependents.
list_employee_fieldsList all employee fields with their names and types, to know which fields exist.
list_employee_filesList the documents stored on an employee's profile, grouped by category. Required: employee_id.
list_employee_onboarding_experiencesList onboarding experiences for a employee. API summary: List employee onboarding experiences.
list_employee_time_off_policies_v1_1List employees. API summary: List Employee Time Off Policies (v1.1).
list_employee_training_recordsGet one employee by employee id. API summary: List Employee Training Records.
list_employeesList employees with paging, sorting and filters (status active/inactive, ids, city, country, hire date and more).
list_employees_2List employees. API summary: List Employee Benefits.
list_employees_list_time_off_policiesList employees. API summary: List Time Off Policies.
list_enrolled_employeesSearch employees by filter, order by or select. Use this to find existing employees before creating a new employee. Results are paginated. API summary: List Enrolled Employees.
list_field_optionsList the option values for list fields such as department, division, location and job title.
list_goal_aggregatesList aggregates for a goal. API summary: Get Goal Aggregate.
list_goal_messagesList messages for a goal. API summary: List Goal Comments.
list_hour_entriesSearch pages by filter or sort. Use this to find existing pages before creating a new page. Results are paginated. API summary: List Hour Entries.
list_import_rowsList rows for a import. Optional filters: errors only. Results are paginated. API summary: List Time Tracking Import Rows.
list_importsList imports. Optional filters: status. Results are paginated. API summary: List Time Tracking Imports.
list_industriesList industries.
list_integrationsList integrations. API summary: Get employee verification integration status.
list_job_titlesList job titles. API summary: Get Job Titles and Level Assignments.
list_job_titles_with_employeesList employees. API summary: List Job Titles with Employees.
list_leadsList leads. API summary: Get Hiring Leads.
list_legacy_field_mapsList legacy field maps. API summary: Get Legacy Report Field Map.
list_legacy_id_mapsList legacy id maps. API summary: Get Legacy Report ID Map.
list_levelsList levels. API summary: List Compensation Level Groups and Levels.
list_locationsList the company's work locations.
list_member_benefitsList member benefits. API summary: List Member Benefit Events.
list_member_benefits_list_member_benefitsList member benefits. Optional filters: calendar year. Results are paginated.
list_monitor_fieldsList monitor fields.
list_optionsList options. Optional filters: iso code. API summary: Get Countries.
list_pagesList pages. Optional filters: start, end or employee ids. API summary: List Timesheet Entries.
list_planning_cycle_adminsList admins for a planning cycle. API summary: List compensation planning cycle admins.
list_planning_cycle_approvalsList approvals for a planning cycle. Optional filters: group by. API summary: Get compensation planning approval flows.
list_planning_cycle_budgetsList budgets for a planning cycle. API summary: Get compensation planning cycle budgets.
list_planning_cycle_change_commsList change comms for a planning cycle. API summary: Get change communication letter details.
list_planning_cycle_employeesList employees for a planning cycle. API summary: List employees in compensation planning cycle.
list_planning_cycle_summariesList summaries for a planning cycle. API summary: Get compensation planning cycle summary.
list_planning_cycle_worksheetsList worksheets for a planning cycle. Optional filters: type. API summary: Get compensation planning cycle worksheet.
list_planning_cyclesList planning cycles. API summary: List compensation planning cycles.
list_projectsList projects. Optional filters: status groups, status ids, sort by or sort order. API summary: Get Job Summaries.
list_provincesList provinces. API summary: Get All Provinces.
list_reportsList the saved custom reports in BambooHR.
list_request_messagesList messages for a request. API summary: List Time Off Request Comments.
list_requestsList requests. Optional filters: id, action, employee id, start, end or type. API summary: List Time Off Requests.
list_reviewsList reviews. API summary: Get Levels and Bands Review.
list_settingsList settings. API summary: Get company equity settings.
list_shiftsList shifts. Optional filters: ids, start, end, employee ids, schedule ids or statuses. Results are paginated.
list_sourcesList sources. API summary: List Compensation Benchmark Sources.
list_statusesList statuses. API summary: Get Applicant Statuses.
list_tablesList tables. API summary: List Tabular Fields.
list_time_off_policiesSearch employees by filter or order by. Use this to find existing employees before creating a new employee. Results are paginated. API summary: List Time Off Policies.
list_time_off_requestsList time off requests, newest first. Narrow with filter (e.g. by employee, status or dates) and order_by.
list_time_off_typesList the time off types (vacation, sick...) and their IDs.
list_timesheet_summariesList summaries for a timesheet. API summary: Get Timesheet Summary.
list_timezonesSearch timezones by sort, select or filter. Use this to find existing timezones before creating a new timezone. Results are paginated. API summary: List timezones.
list_toolsList tools. API summary: List available compensation tools.
list_total_reward_printablesList printables for a total reward. Optional filters: multiplier or year. API summary: Get Printable Total Rewards Statement.
list_total_reward_statementsList statements for a total reward. API summary: Get Total Rewards Statement.
list_training_typesList types. API summary: List Training Types.
list_typesList types. API summary: List Custom Field Types.
list_usersList users. Optional filters: status.
list_viewsList views. API summary: Get Company Files and Categories.
list_webhook_logsList logs for a webhook. API summary: List Webhook Logs.
list_webhooksList webhooks.
list_who_s_outSearch whos outs by start, end or filter. Use this to find existing whos outs before creating a new whos out. API summary: List Who’s Out.
list_whos_outList who is out (time off and holidays) between two dates. Required: start and end (YYYY-MM-DD).
pay_grades_and_bandMoves moneyPay a grades and band. Financial or irreversible action; may require approval. API summary: Get Published Levels and Bands.
pay_pay_grades_and_band_bandsMoves moneyPay a pay grades and band. Financial or irreversible action; may require approval. API summary: Get Pay Bands.
query_datasetChanges dataQuery a dataset for a custom report on the fly. Required: dataset_name and fields. Optional: filter, order_by, page_size.
reopen_goalVisible to othersReopen a goal (goal id). Has effects visible outside this system. API summary: Reopen Goal.
restore_custom_fieldChanges dataUnarchive a custom field. API summary: Unarchive Custom Fields.
run_reportRun a saved custom report and return its rows. Required: report_id.
search_aggregatesSearch aggregates by filter. Use this to find existing aggregates before creating a new aggregate. API summary: Get Goals Aggregate (v1.2).
search_applicationsSearch applications by job id, application status id, application status, job status groups, search string or sort by. Use this to find existing applications before creating a new application. Results are paginated. API summary: Get Job Applications.
search_break_assessmentsSearch break assessments by filter. Use this to find existing break assessments before creating a new break assessment. Results are paginated. API summary: List Break Assessments.
search_break_policiesSearch break policies by filter or include counts. Use this to find existing break policies before creating a new break policy. Results are paginated. API summary: List Break Policies.
search_break_policy_breaksSearch breaks for a break policy by filter. Use this to find existing breaks before creating a new break. Results are paginated. API summary: List Breaks for Break Policy.
search_calendar_eventsSearch calendar events by start, end, filter, direct reports only or include persons. Use this to find existing calendar events before creating a new calendar event. Results are paginated. API summary: List Calendar Events.
search_catalogsSearch catalogs by country code, year, filter or order by. Use this to find existing catalogs before creating a new catalog. Results are paginated. API summary: List Catalog Holidays.
search_companiesSearch companies by filter, order by or select. Use this to find existing companies before creating a new company. Results are paginated. API summary: List Company Holidays.
search_configurationsSearch configurations by filter, order by or select. Use this to find existing configurations before creating a new configuration. Results are paginated. API summary: List Configurations.
search_employee_goalsSearch goals for a employee by filter. Use this to find existing goals before creating a new goal. API summary: List Goals.
search_employee_versionsSearch versions for a employee by filter. Use this to find existing versions before creating a new version. Results are paginated. API summary: List Time Off Policy Versions.
search_employeesSearch employees by filter. Use this to find existing employees before creating a new employee. Results are paginated. API summary: List Employee Time Off Policies.
search_filtersSearch filters. Use this to find existing filters before creating a new filter. API summary: Get Goal Filters (v1.2).
search_kiosksSearch kiosks by filter, order by or select. Use this to find existing kiosks before creating a new kiosk. Results are paginated. API summary: List Time Tracking Kiosks.
search_project_tasksSearch tasks for a project by filter, sort or statuses. Use this to find existing tasks before creating a new task. Results are paginated. API summary: List Time Tracking Project Tasks.
search_projectsSearch projects by filter or sort. Use this to find existing projects before creating a new project. Results are paginated. API summary: List Time Tracking Projects.
search_schedulesSearch schedules by filter or sort. Use this to find existing schedules before creating a new schedule. Results are paginated. API summary: List Schedules.
search_share_optionsSearch share options by search. Use this to find existing share options before creating a new share option. Results are paginated. API summary: List Goal Sharing Options.
search_shift_assessmentsSearch shift assessments by filter or sort. Use this to find existing shift assessments before creating a new shift assessment. Results are paginated. API summary: List Shift Assessments.
search_shift_differentialsSearch shift differentials by filter or sort. Use this to find existing shift differentials before creating a new shift differential. Results are paginated. API summary: List Time Tracking Shift Differentials.
search_time_clocksSearch time clocks by filter, order by or select. Use this to find existing time clocks before creating a new time clock. Results are paginated. API summary: List Time Tracking Time Clocks.
search_timesheetsSearch timesheets by filter or sort. Use this to find existing timesheets before creating a new timesheet. Results are paginated. API summary: List Timesheets.
search_timezonesSearch timezones by filter or sort. Use this to find existing timezones before creating a new timezone. Results are paginated. API summary: List Timezones.
send_new_hire_packetVisible to othersSend a new hire packet (new hire packet id). Has effects visible outside this system. API summary: Send new hire packet.
send_recommendationVisible to othersSend a recommendation (planning cycle id). Has effects visible outside this system. API summary: Send recommendations to next stage.
send_user_emailVisible to othersSend a user (user id). Has effects visible outside this system. API summary: Send employee verification lifecycle email by user and email type.
submit_break_policyVisible to othersSync a break policy (break policy id). Has effects visible outside this system. API summary: Sync Break Policy.
submit_goalVisible to othersClose a goal (goal id). Has effects visible outside this system. API summary: Close Goal.
submit_pay_grades_and_bandMoves moneyPublish a pay grades and band. Financial or irreversible action; may require approval. API summary: Publish Draft Compensation Level Groups.
submit_planning_cycleVisible to othersComplete a planning cycle (planning cycle id). Has effects visible outside this system. API summary: Complete compensation planning cycle.
submit_shiftVisible to othersPublish a shift. Has effects visible outside this system. API summary: Publish Shifts.
update_addressChanges dataUpdate an existing address identified by address id. API summary: Update a job location.
update_adjustsVisible to othersUpdate an existing adjust. Has effects visible outside this system. API summary: Update Hour Record.
update_alert_configurationChanges dataUpdate an existing alert configuration identified by alert configuration id. API summary: Replace Alert Configuration.
update_balance_adjustmentsVisible to othersUpdate an existing balance adjustment identified by employee id. Has effects visible outside this system. API summary: Adjust Time Off Balance.
update_benchmarksVisible to othersUpdate an existing benchmark. Has effects visible outside this system. API summary: Update Compensation Benchmark.
update_breakChanges dataUpdate an existing break identified by break id. Only the fields you pass are changed. API summary: Update Break.
update_break_policyChanges dataUpdate an existing break policy identified by break policy id. Only the fields you pass are changed. API summary: Update Break Policy.
update_break_policy_breaksVisible to othersUpdate an existing break identified by break policy id. Has effects visible outside this system. API summary: Replace Breaks for Break Policy.
update_breakdownsVisible to othersUpdate an existing breakdown identified by planning cycle id. Has effects visible outside this system. API summary: Save budget breakdown.
update_categoryChanges dataUpdate an existing category identified by category id. Only the fields you pass are changed. API summary: Update Time Off Category.
update_companyChanges dataUpdate an existing company identified by company id. Only the fields you pass are changed. API summary: Update Company Holiday.
update_company_informationVisible to othersUpdate an existing company information. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update company information (phone, address, legal name).
update_configurationChanges dataUpdate an existing configuration identified by configuration id. Only the fields you pass are changed. API summary: Update Configuration.
update_custom_disclaimersVisible to othersUpdate an existing custom disclaimer. Has effects visible outside this system. API summary: Set Total Rewards Custom Disclaimer.
update_custom_fieldChanges dataUpdate an existing custom field identified by custom field id. API summary: Edit Custom Field.
update_custom_field_list_valueChanges dataUpdate an existing list value identified by list value id. Only the fields you pass are changed. API summary: Edit Custom Field List Value.
update_custom_tableChanges dataUpdate an existing custom table identified by custom table id. API summary: Update Custom Table.
update_display_namesVisible to othersUpdate an existing display name. Has effects visible outside this system. API summary: Update company display name.
update_documentChanges dataUpdate an existing document identified by document id. API summary: Update Company File.
update_employeeChanges dataUpdate an employee's basic fields: name, job title, department, division, location, hire date, phone numbers, work email and address. Required: employee_id.
update_employee_2Changes dataUpdate an existing employee identified by assignment id. Only the fields you pass are changed. API summary: Update Employee Time Off Policy Assignment.
update_employee_dependentChanges dataUpdate an existing employee identified by employee id. API summary: Update Employee Dependent.
update_employee_documentChanges dataUpdate an existing document identified by document id. API summary: Update Employee File.
update_employee_enrollmentChanges dataUpdate an existing employee identified by employee id. Only the fields you pass are changed. API summary: Update Employee Enrollment.
update_employee_goalChanges dataUpdate an existing goal identified by goal id. API summary: Update Goal (v1.1).
update_employee_tableChanges dataUpdate an existing table identified by row id. API summary: Update Table Row (v1.1).
update_final_approverChanges dataUpdate an existing final approver identified by employee id. API summary: Set final approver.
update_goal_messageChanges dataUpdate an existing message identified by message id. API summary: Update Goal Comment.
update_goal_progressVisible to othersUpdate an existing progress identified by goal id. Has effects visible outside this system. API summary: Update Goal Progress.
update_goal_shared_withsVisible to othersUpdate an existing shared with identified by goal id. Has effects visible outside this system. API summary: Update Goal Sharing.
update_guidelinesVisible to othersUpdate an existing guideline identified by planning cycle id. Has effects visible outside this system. API summary: Save budget guidelines.
update_historiesVisible to othersUpdate an existing history identified by employee id. Has effects visible outside this system. API summary: Create Time Off History Item.
update_hour_entryChanges dataUpdate an existing page identified by page id. Only the fields you pass are changed. API summary: Update Hour Entry.
update_import_rowChanges dataUpdate an existing row identified by row id. Only the fields you pass are changed. API summary: Update Time Tracking Import Row.
update_industry_codesVisible to othersUpdate an existing industry code. Has effects visible outside this system. API summary: Update Company Industry Codes.
update_integrationsVisible to othersUpdate an existing integration. Has effects visible outside this system. API summary: Enable or disable the employee verification integration.
update_job_titlesMoves moneyUpdate an existing job title. Financial or irreversible action; may require approval. API summary: Replace Job Title Level Assignments.
update_kioskChanges dataUpdate an existing kiosk identified by kiosk id. Only the fields you pass are changed. API summary: Update Time Tracking Kiosk.
update_levelsMoves moneyUpdate an existing level. Financial or irreversible action; may require approval. API summary: Update Compensation Level Groups and Levels.
update_listChanges dataUpdate an existing list identified by list field id. API summary: Update List Field Values.
update_milestone_progressVisible to othersUpdate an existing progress identified by milestone id. Has effects visible outside this system. API summary: Update Milestone Progress.
update_new_hire_packetChanges dataUpdate an existing new hire packet identified by new hire packet id. API summary: Update new hire packet.
update_new_hire_packet_question_visibilitiesVisible to othersUpdate an existing question visibility identified by new hire packet id. Has effects visible outside this system. API summary: Update GTKY answer visibility for a new hire packet.
update_onboardingChanges dataUpdate an existing onboarding identified by step name. API summary: Set Total Rewards Onboarding Step Status.
update_pageChanges dataUpdate an existing page identified by page id. Only the fields you pass are changed. API summary: Update Clock Entry.
update_pay_bandsMoves moneyPay a pay grades and band. Financial or irreversible action; may require approval. API summary: Update Pay Bands.
update_planning_cycleChanges dataUpdate an existing planning cycle identified by planning cycle id. API summary: Update compensation planning cycle.
update_planning_cycle_approvalChanges dataUpdate an existing approval identified by template id. API summary: Update approval flow.
update_planning_cycle_launchesVisible to othersUpdate an existing launch identified by planning cycle id. Has effects visible outside this system. API summary: Launch compensation planning cycle.
update_projectChanges dataUpdate an existing project identified by project id. Only the fields you pass are changed. API summary: Update Time Tracking Project.
update_recordChanges dataUpdate an existing record identified by employee training record id. API summary: Update Employee Training Record.
update_reordersVisible to othersUpdate an existing reorder identified by custom table id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Reorder Custom Table Fields.
update_requestChanges dataUpdate an existing request identified by request id. Only the fields you pass are changed. API summary: Update Time Off Request.
update_scheduleChanges dataUpdate an existing schedule identified by schedule id. Only the fields you pass are changed. API summary: Update Schedule.
update_settingsVisible to othersUpdate an existing setting. Has effects visible outside this system. API summary: Update company equity settings.
update_shiftChanges dataUpdate an existing shift identified by shift id. Only the fields you pass are changed. API summary: Update Shift.
update_shift_differentialChanges dataUpdate an existing shift differential identified by shift differential id. Only the fields you pass are changed. API summary: Update Time Tracking Shift Differential.
update_sourcesVisible to othersUpdate an existing source. Has effects visible outside this system. API summary: Update Compensation Benchmark Sources.
update_taskChanges dataUpdate an existing task identified by task id. Only the fields you pass are changed. API summary: Update Time Tracking Task.
update_templatesVisible to othersUpdate an existing template identified by planning cycle id. Has effects visible outside this system. API summary: Save change comm template.
update_time_clockChanges dataUpdate an existing time clock identified by time clock id. Only the fields you pass are changed. API summary: Update Time Tracking Time Clock.
update_typeChanges dataUpdate an existing type identified by training type id. API summary: Update Training Type.
update_webhookDeletesUpdate an existing webhook identified by webhook id. Destructive action; may require approval. API summary: Update Webhook.
upload_budgetChanges dataImport a budget (planning cycle id). API summary: Import budget breakdown.
upload_photoChanges dataUpload a photo (employee id). API summary: Upload Employee Photo.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose BambooHR from the app list.
2
Paste your key
Enter your BambooHR subdomain (the "acme" in acme.bamboohr.com), your API key and the letter x as the password. To create the key, click your name in the lower-left corner of BambooHR, choose API Keys and add a new key. The key has the same access as your own BambooHR user.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in BambooHR?

The AI can read employees, the directory, employee history tables and files, time off requests and balances, who is out, clock entries, saved reports and datasets. It can create and update employees, create time off requests, approve, deny or cancel them, and clock employees in and out.

Does the AI see my BambooHR credentials?

No. Your BambooHR API key is encrypted at rest and never shown to the AI. After you save it, it is not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start with read tools like the directory and who is out. HR data is sensitive: get_employee_table can read history tables such as compensation, so leave it off if the AI should not see pay. Approving, denying and creating time off can require your approval before they run, and every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own BambooHR account.

Does the employee get notified when the AI approves time off?

Yes. When the AI approves or denies a time off request, BambooHR notifies the employee, the same as when a manager does it. Creating a request with the status approved records it as already approved. Require approval for these tools if you want to check each one first.