Skip to main content
Server path: /bamboohr-compensation | Type: Application | PCID required: Yes

Tools

ToolDescription
bamboohr_compensation_create_compensation_benchmarkCreate Compensation Benchmark
bamboohr_compensation_create_compensation_benchmark_sourceCreate Compensation Benchmark Source
bamboohr_compensation_create_employee_dependentCreate Employee Dependent
bamboohr_compensation_delete_benchmarkDelete Compensation Benchmark
bamboohr_compensation_delete_benchmark_sourceDelete Compensation Benchmark Source
bamboohr_compensation_export_compensation_benchmark_detailsExport Compensation Benchmark Details
bamboohr_compensation_get_benchmark_detailsGet Compensation Benchmark Details
bamboohr_compensation_get_employee_dependentGet Employee Dependent
bamboohr_compensation_get_planning_cyclesGet compensation planning cycle details
bamboohr_compensation_import_compensation_benchmarksImport Compensation Benchmarks From CSV
bamboohr_compensation_list_benefit_coveragesList Benefit Coverages
bamboohr_compensation_list_benefit_deduction_typesList Benefit Deduction Types
bamboohr_compensation_list_company_benefitsList Company Benefits
bamboohr_compensation_list_compensation_benchmark_sourcesList Compensation Benchmark Sources
bamboohr_compensation_list_compensation_benchmarksList Compensation Benchmarks
bamboohr_compensation_list_compensation_equity_settingsGet company equity settings
bamboohr_compensation_list_compensation_planning_cyclesList compensation planning cycles
bamboohr_compensation_list_compensation_planning_cycles_adminsList compensation planning cycle admins
bamboohr_compensation_list_compensation_planning_cycles_approvalsGet compensation planning approval flows
bamboohr_compensation_list_compensation_planning_cycles_budgetsGet compensation planning cycle budgets
bamboohr_compensation_list_compensation_planning_cycles_change_commGet change communication letter details
bamboohr_compensation_list_compensation_planning_cycles_employeesList employees in compensation planning cycle
bamboohr_compensation_list_compensation_planning_cycles_summaryGet compensation planning cycle summary
bamboohr_compensation_list_compensation_planning_cycles_worksheetGet compensation planning cycle worksheet
bamboohr_compensation_list_compensation_planning_cycles_worksheet_exportExport compensation planning cycle worksheet to CSV
bamboohr_compensation_list_employee_benefitsList Employee Benefits
bamboohr_compensation_list_employee_dependentsList Employee Dependents
bamboohr_compensation_list_member_benefit_eventsList Member Benefit Events
bamboohr_compensation_list_member_benefitsList Member Benefits
bamboohr_compensation_update_compensation_benchmarkUpdate Compensation Benchmark
bamboohr_compensation_update_compensation_benchmark_sourcesUpdate Compensation Benchmark Sources
bamboohr_compensation_update_employee_dependentUpdate Employee Dependent

bamboohr_compensation_create_compensation_benchmark

Create Compensation Benchmark Parameters:
ParameterTypeRequiredDefaultDescription
benchmarkMaxnumberYesBenchmark maximum value.
benchmarkMinnumberYesBenchmark minimum value.
benchmarkSourcestringNoFree-text label describing where the benchmark came from.
benchmarkValuenumberYesBenchmark median value.
companiesSurveyedintegerNoCompanies Surveyed
currencyCodestringYesISO 4217 currency code for the benchmark values.
dataYearstringNoYear of the underlying survey data.
employeesSurveyedintegerNoEmployees Surveyed
externalCompanySizestringNoExternal Company Size
externalCountrystringNoExternal Country
externalIndustrystringNoExternal Industry
externalJobDescriptionstringNoExternal Job Description
externalJobTitlestringNoExternal Job Title
externalLevelstringNoExternal Level
externalLocationstringNoExternal Location
externalSecondaryLocationstringNoExternal Secondary Location
jobLocationIdstringNoOptional job location ID to scope the benchmark to a specific location.
jobTitleIdstringYesID of the company job title the benchmark applies to.
mjlJobCodestringNoMercer Job Library code associated with this benchmark. Stored on the benchmark as mercerJobCode.
sourceDatestringNoDate the benchmark source data applies to.
sourceIdstringNoID of the benchmark source from GET /api/v1/compensation/benchmarks/sources.

bamboohr_compensation_create_compensation_benchmark_source

Create Compensation Benchmark Source Parameters:
ParameterTypeRequiredDefaultDescription
colorCodestringNoOptional hex color used to display the source in the UI.
namestringYesDisplay name for the new benchmark source. Cannot be empty or equal to mercer.

bamboohr_compensation_create_employee_dependent

Create Employee Dependent Parameters:
ParameterTypeRequiredDefaultDescription
addressLine1stringNoThe first line of the dependent’s address.
addressLine2stringNoThe second line of the dependent’s address.
citystringNoThe dependent’s city.
countrystringNoThe dependent’s country, provided as an ISO 3166-1 alpha-2 country code (e.g. “US”). Returned as a full country name on read.
dateOfBirthstringNoThe dependent’s date of birth in YYYY-MM-DD format.
employeeIdstringYesThe ID of the employee this dependent belongs to. Required.
firstNamestringNoThe dependent’s first name.
genderstringNoThe dependent’s gender.
homePhonestringNoThe dependent’s home phone number.
isStudentstringNoWhether the dependent is currently a student. Accepted values: “yes” or “no”.
isUsCitizenstringNoWhether the dependent is a US citizen. Accepted values: “yes” or “no”.
lastNamestringNoThe dependent’s last name.
middleNamestringNoThe dependent’s middle name.
relationshipstringNoThe dependent’s relationship to the employee (e.g. “spouse”, “child”, “domestic_partner”).
sinstringNoThe dependent’s Social Insurance Number (Canadian equivalent of SSN), provided as plain text. Stored encrypted. Returned as a masked value on read.
ssnstringNoThe dependent’s Social Security Number, provided as plain text. Stored encrypted. Returned as a masked value (e.g. “xxx-xx-1234”) on read.
statestringNoThe dependent’s state, provided as a state code (e.g. “UT”). Returned as a full state name on read.
zipCodestringNoThe dependent’s ZIP or postal code.

bamboohr_compensation_delete_benchmark

Delete Compensation Benchmark Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesInteger ID of the compensation benchmark to delete.

bamboohr_compensation_delete_benchmark_source

Delete Compensation Benchmark Source Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesID of the benchmark source to delete. Must be non-empty.

bamboohr_compensation_export_compensation_benchmark_details

Export Compensation Benchmark Details Parameters:
ParameterTypeRequiredDefaultDescription
jobIdstringYesID of the company job title to export benchmark details for.
locationIdstringNoOptional job location ID to restrict the export to one location.

bamboohr_compensation_get_benchmark_details

Get Compensation Benchmark Details Parameters:
ParameterTypeRequiredDefaultDescription
jobIdstringYesID of the company job title to fetch benchmark details for.
locationIdstringNoOptional job location ID. When omitted, results aggregate across all locations for the job.

bamboohr_compensation_get_employee_dependent

Get Employee Dependent Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe numeric ID of the employee dependent to retrieve.

bamboohr_compensation_get_planning_cycles

Get compensation planning cycle details Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe id value

bamboohr_compensation_import_compensation_benchmarks

Import Compensation Benchmarks From CSV Parameters:
ParameterTypeRequiredDefaultDescription
filestringYesCSV file to import.

bamboohr_compensation_list_benefit_coverages

List Benefit Coverages

bamboohr_compensation_list_benefit_deduction_types

List Benefit Deduction Types

bamboohr_compensation_list_company_benefits

List Company Benefits

bamboohr_compensation_list_compensation_benchmark_sources

List Compensation Benchmark Sources

bamboohr_compensation_list_compensation_benchmarks

List Compensation Benchmarks

bamboohr_compensation_list_compensation_equity_settings

Get company equity settings

bamboohr_compensation_list_compensation_planning_cycles

List compensation planning cycles

bamboohr_compensation_list_compensation_planning_cycles_admins

List compensation planning cycle admins Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe id value

bamboohr_compensation_list_compensation_planning_cycles_approvals

Get compensation planning approval flows Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe id value
groupBystringNoOptional grouping for flows (e.g. department)

bamboohr_compensation_list_compensation_planning_cycles_budgets

Get compensation planning cycle budgets Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe id value

bamboohr_compensation_list_compensation_planning_cycles_change_comm

Get change communication letter details Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe id value

bamboohr_compensation_list_compensation_planning_cycles_employees

List employees in compensation planning cycle Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe id value

bamboohr_compensation_list_compensation_planning_cycles_summary

Get compensation planning cycle summary Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe id value

bamboohr_compensation_list_compensation_planning_cycles_worksheet

Get compensation planning cycle worksheet Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe id value
typestringNoWorksheet context: recommendations, approvals, or overview (overview requires cycle admin).

bamboohr_compensation_list_compensation_planning_cycles_worksheet_export

Export compensation planning cycle worksheet to CSV Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe id value
typestringNoWorksheet context: recommendations, approvals, or overview (overview requires cycle admin).

bamboohr_compensation_list_employee_benefits

List Employee Benefits Parameters:
ParameterTypeRequiredDefaultDescription
filtersobjectYesScope filters for the request. At least one of employeeId, companyBenefitId, or enrollmentStatusEffectiveDate must be provided; omitting all three returns a 400 validation error.

bamboohr_compensation_list_employee_dependents

List Employee Dependents Parameters:
ParameterTypeRequiredDefaultDescription
employeeidintegerNoThe employee ID to filter dependents by. When provided, only dependents for that employee are returned. When omitted, all company dependents are returned.

bamboohr_compensation_list_member_benefit_events

List Member Benefit Events

bamboohr_compensation_list_member_benefits

List Member Benefits Parameters:
ParameterTypeRequiredDefaultDescription
calendarYearstringYesThe 4-digit calendar year (YYYY) to retrieve benefit enrollment data for.
pagestringNoThe 1-based page number for pagination. The value is cast to an integer; values that cast to 0 or below are rejected with a 400. Defaults to 1.
pageSizestringNoThe number of items per page. The value is cast to an integer; values that cast to 0 or below, or to 100 or above, are rejected with a 400. Defaults to 25.

bamboohr_compensation_update_compensation_benchmark

Update Compensation Benchmark Parameters:
ParameterTypeRequiredDefaultDescription
benchmarkMaxnumberNoBenchmark maximum value.
benchmarkMinnumberNoBenchmark minimum value.
benchmarkSourcestringNoFree-text label describing where the benchmark came from.
benchmarkValuenumberNoBenchmark median value.
companiesSurveyedintegerNoCompanies Surveyed
currencyCodestringNoISO 4217 currency code for the benchmark values.
dataYearstringNoYear of the underlying survey data. Omitting this field clears data_year on the stored benchmark, so callers updating a Mercer benchmark should resend the existing value.
employeesSurveyedintegerNoEmployees Surveyed
externalCompanySizestringNoExternal Company Size
externalCountrystringNoExternal Country
externalIndustrystringNoExternal Industry
externalJobDescriptionstringNoExternal Job Description
externalJobTitlestringNoExternal Job Title
externalLevelstringNoExternal Level
externalLocationstringNoExternal Location
externalSecondaryLocationstringNoExternal Secondary Location
idstringNoID of the benchmark to update.
mjlJobCodestringNoMercer Job Library code associated with this benchmark. Stored on the benchmark as mercerJobCode.
sourceDatestringNoDate the benchmark source data applies to.
sourceIdstringNoID of the benchmark source from GET /api/v1/compensation/benchmarks/sources.

bamboohr_compensation_update_compensation_benchmark_sources

Update Compensation Benchmark Sources Parameters:
ParameterTypeRequiredDefaultDescription
benchmarkSourcesobject[]NoBenchmark Sources

bamboohr_compensation_update_employee_dependent

Update Employee Dependent Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesThe numeric ID of the employee dependent to update.
addressLine1stringNoThe first line of the dependent’s address.
addressLine2stringNoThe second line of the dependent’s address.
citystringNoThe dependent’s city.
countrystringNoThe dependent’s country, provided as an ISO 3166-1 alpha-2 country code (e.g. “US”). Returned as a full country name on read.
dateOfBirthstringNoThe dependent’s date of birth in YYYY-MM-DD format.
employeeIdstringNoThe ID of the employee this dependent belongs to. Required.
firstNamestringNoThe dependent’s first name.
genderstringNoThe dependent’s gender.
homePhonestringNoThe dependent’s home phone number.
isStudentstringNoWhether the dependent is currently a student. Accepted values: “yes” or “no”.
isUsCitizenstringNoWhether the dependent is a US citizen. Accepted values: “yes” or “no”.
lastNamestringNoThe dependent’s last name.
middleNamestringNoThe dependent’s middle name.
relationshipstringNoThe dependent’s relationship to the employee (e.g. “spouse”, “child”, “domestic_partner”).
sinstringNoThe dependent’s Social Insurance Number (Canadian equivalent of SSN), provided as plain text. Stored encrypted. Returned as a masked value on read.
ssnstringNoThe dependent’s Social Security Number, provided as plain text. Stored encrypted. Returned as a masked value (e.g. “xxx-xx-1234”) on read.
statestringNoThe dependent’s state, provided as a state code (e.g. “UT”). Returned as a full state name on read.
zipCodestringNoThe dependent’s ZIP or postal code.