> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# BambooHR Changelog

> Release history for the BambooHR connector. Each version lists what changed and which actions were affected.

<Card title="BambooHR connector" icon="arrow-left" href="/connectors/bamboohr" horizontal>
  Back to the connector overview, authentication methods, and actions.
</Card>

<Update label="v2.1.0" description="10 Sept 2026">
  `improvement`

  Added data sync support to 24 list actions - including employees, the employee directory, time-off types and policies, benefits, holidays, time-tracking projects, reports, job openings, and job applications - so their records can be periodically pulled and kept up to date, with pagination handled automatically.

  <AccordionGroup>
    <Accordion title="Changed · 24 actions updated">
      `bamboohr_list_applicant_statuses`, `bamboohr_list_benefit_coverages`, `bamboohr_list_benefit_deduction_types`, `bamboohr_list_company_files`, `bamboohr_list_company_locations`, `bamboohr_list_countries`, `bamboohr_list_datasets`, `bamboohr_list_employees`, `bamboohr_list_employees_directory`, `bamboohr_list_fields`, `bamboohr_list_hiring_leads`, `bamboohr_list_holidays`, `bamboohr_list_job_applications`, `bamboohr_list_job_summaries`, `bamboohr_list_list_fields`, `bamboohr_list_member_benefit_events`, `bamboohr_list_monitor_fields`, `bamboohr_list_reports`, `bamboohr_list_tabular_fields`, `bamboohr_list_time_off_policies`, `bamboohr_list_time_off_types`, `bamboohr_list_time_tracking_projects`, `bamboohr_list_webhooks`, `bamboohr_list_whos_out`
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="v2.0.6" description="9 Sept 2026">
  `improvement` `documentation`

  Clarified the time-tracking write actions so agents pick the right one for a worked-from/to timesheet entry - Create Or Update Clock Entries now states it records entries with explicit start and end times, and Create Hour Record states it stores only a total-hours figure without start/end times. List Employees now states up front that it resolves an employee ID from a name and filters employees by status, department, job title, pay type and other attributes.

  <AccordionGroup>
    <Accordion title="Changed · 3 actions updated">
      `bamboohr_create_hour_record`, `bamboohr_create_or_update_clock_entries`, `bamboohr_list_employees`
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="v2.0.5" description="8 Sept 2026">
  `improvement` `documentation` `bug-fix`

  Removed pdf and xls formats from request\_custom\_report because the endpoint returns binary data that was being decoded as text, producing corrupt files; json, xml, and csv remain supported.

  <AccordionGroup>
    <Accordion title="Changed · 1 action updated">
      `bamboohr_request_custom_report`
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="v2.0.4" description="3 Sept 2026">
  `improvement` `documentation` `bug-fix`

  Fixed the employee-dependent relationship field to accept only the values BambooHR supports (child, spouse, domestic partner), so creating and updating dependents no longer fails with an invalid-relationship error. Clarified action guidance to match real provider behavior — the employee directory cannot filter or sort (use list employees), job summaries return job openings rather than candidate applications, custom-report fields take API field IDs sent as one array, table-row updates require exact list values, added employmentStatus and comment fields to the table-row actions so employee offboarding/termination via the employmentStatus table now works (previously there was no way to write the status value), project tasks can only be added when the project was created with tasks enabled, recording a used time-off history item conflicts when the approved request already has one, and time-off policy assignment sets or replaces the policy for a given time-off type (re-assigning the same policy is rejected as already-assigned). Documented time-tracking timesheet-type requirements (clock in/out needs a clock-in/out timesheet while hour entries need a total-hours timesheet) and improved time-tracking field typing and descriptions.

  <AccordionGroup>
    <Accordion title="Changed · 5 actions updated">
      `bamboohr_create_table_row`, `bamboohr_create_time_off_history_item`, `bamboohr_list_job_applications`, `bamboohr_request_custom_report`, `bamboohr_update_table_row`
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="v2.0.3" description="2 Sept 2026">
  `improvement` `documentation` `bug-fix`

  Fixed the employee-dependent relationship field to accept only the values BambooHR supports (child, spouse, domestic partner), so creating and updating dependents no longer fails with an invalid-relationship error. Clarified action guidance to match real provider behavior — the employee directory cannot filter or sort (use list employees), job summaries return job openings rather than candidate applications, custom-report fields take API field IDs sent as one array, table-row updates require exact list values, employee termination is done by adding an employmentStatus table row, project tasks can only be added when the project was created with tasks enabled, recording a used time-off history item conflicts when the approved request already has one, and time-off policy assignment sets or replaces the policy for a given time-off type (re-assigning the same policy is rejected as already-assigned). Documented time-tracking timesheet-type requirements (clock in/out needs a clock-in/out timesheet while hour entries need a total-hours timesheet) and improved time-tracking field typing and descriptions.

  <AccordionGroup>
    <Accordion title="Changed · 6 actions updated">
      `bamboohr_assign_time_off_policies`, `bamboohr_create_project_task`, `bamboohr_create_table_row`, `bamboohr_create_time_off_history_item`, `bamboohr_list_job_summaries`, `bamboohr_request_custom_report`
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="v2.0.2" description="1 Sept 2026">
  `improvement` `documentation` `bug-fix`

  Fixed the employee-dependent relationship field to use the values BambooHR actually accepts (child, spouse, domestic partner), so creating and updating dependents no longer fails with an invalid-relationship error. Clarified several action descriptions to match real behavior — the employee directory does not accept filters or sorting (use list employees for that), job summaries return job openings rather than candidate applications, custom-report fields take API field IDs (not display labels), and table-row updates require exact list values. Documented time-tracking timesheet-type requirements (clock in/out needs a clock-in/out timesheet while hour entries need a total-hours timesheet) and improved time-tracking field typing and descriptions.

  <AccordionGroup>
    <Accordion title="Changed · 25 actions updated">
      `bamboohr_clock_in_employee`, `bamboohr_clock_out_employee`, `bamboohr_create_employee_dependent`, `bamboohr_create_hour_record`, `bamboohr_create_or_update_clock_entries`, `bamboohr_create_or_update_hour_entries`, `bamboohr_create_project_task`, `bamboohr_create_time_tracking_project`, `bamboohr_delete_clock_entries`, `bamboohr_delete_hour_entries`, `bamboohr_delete_hour_record`, `bamboohr_get_hour_record`, `bamboohr_list_break_policies`, `bamboohr_list_break_policy_breaks`, `bamboohr_list_employees_directory`, `bamboohr_list_holidays`, `bamboohr_list_job_summaries`, `bamboohr_list_project_tasks`, `bamboohr_list_shift_differentials`, `bamboohr_list_time_tracking_projects`, `bamboohr_list_timesheet_entries`, `bamboohr_request_custom_report`, `bamboohr_update_employee_dependent`, `bamboohr_update_hour_record`, `bamboohr_update_table_row`
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="v2.0.1" description="18 Aug 2026">
  `improvement` `documentation` `bug-fix`

  Overhauled the OAuth setup guide with step screenshots, clearer portal navigation, correct button labels, an application-name example, and a masked-credential reveal step, and aligned the documented application scopes with those actually requested (deduplicated to top-level scopes, since each write scope already includes its read). Corrected several action descriptions to match real BambooHR behavior — employee name-filter and sort-field formats (plus a new jobTitleName field), routing employment-status and termination changes through the employment-status table, the employeeCompDate companion-field rule (required for exempt/payRate, not payType), a required file extension on uploads, exact-value matching for list-type fields when adding table rows, and time-off policy listing (company-wide vs per-employee) and assignment (assigning an already-held policy is a silent no-op, not an error).

  <AccordionGroup>
    <Accordion title="Changed · 107 actions updated">
      `bamboohr_assign_time_off_policies`, `bamboohr_clock_in_employee`, `bamboohr_clock_out_employee`, `bamboohr_close_goal`, `bamboohr_create_application_comment`, `bamboohr_create_candidate`, `bamboohr_create_company_file_category`, `bamboohr_create_employee`, `bamboohr_create_employee_dependent`, `bamboohr_create_employee_file_category`, `bamboohr_create_employee_training_record`, `bamboohr_create_goal`, `bamboohr_create_goal_comment`, `bamboohr_create_hour_record`, `bamboohr_create_job_opening`, `bamboohr_create_or_update_clock_entries`, `bamboohr_create_or_update_hour_entries`, `bamboohr_create_or_update_list_values`, `bamboohr_create_project_task`, `bamboohr_create_table_row`, `bamboohr_create_time_off_history_item`, `bamboohr_create_time_off_request`, `bamboohr_create_time_tracking_project`, `bamboohr_create_training_category`, `bamboohr_create_training_type`, `bamboohr_create_webhook`, `bamboohr_delete_clock_entries`, `bamboohr_delete_company_file`, `bamboohr_delete_employee_training_record`, `bamboohr_delete_goal`, `bamboohr_delete_hour_entries`, `bamboohr_delete_hour_record`, `bamboohr_delete_table_row`, `bamboohr_delete_training_type`, `bamboohr_delete_webhook`, `bamboohr_estimate_future_time_off_balances`, `bamboohr_get_changed_employee_ids`, `bamboohr_get_company_file`, `bamboohr_get_company_information`, `bamboohr_get_dataset_data`, `bamboohr_get_dataset_fields`, `bamboohr_get_employee`, `bamboohr_get_employee_file_categories`, `bamboohr_get_employee_photo`, `bamboohr_get_employee_table_rows`, `bamboohr_get_employee_time_off_policies`, `bamboohr_get_field_options`, `bamboohr_get_hour_record`, `bamboohr_get_job_application_details`, `bamboohr_get_report`, `bamboohr_get_states_by_country`, `bamboohr_get_webhook`, `bamboohr_get_webhook_logs`, `bamboohr_list_applicant_statuses`, `bamboohr_list_benefit_coverages`, `bamboohr_list_benefit_deduction_types`, `bamboohr_list_break_policies`, `bamboohr_list_break_policy_breaks`, `bamboohr_list_company_files`, `bamboohr_list_company_locations`, `bamboohr_list_countries`, `bamboohr_list_datasets`, `bamboohr_list_employee_dependents`, `bamboohr_list_employee_files`, `bamboohr_list_employee_trainings`, `bamboohr_list_employees`, `bamboohr_list_employees_directory`, `bamboohr_list_fields`, `bamboohr_list_goal_alignment_options`, `bamboohr_list_goals`, `bamboohr_list_hiring_leads`, `bamboohr_list_holidays`, `bamboohr_list_job_applications`, `bamboohr_list_job_summaries`, `bamboohr_list_list_fields`, `bamboohr_list_member_benefit_events`, `bamboohr_list_monitor_fields`, `bamboohr_list_project_tasks`, `bamboohr_list_reports`, `bamboohr_list_shift_differentials`, `bamboohr_list_tabular_fields`, `bamboohr_list_time_off_policies`, `bamboohr_list_time_off_requests`, `bamboohr_list_time_off_types`, `bamboohr_list_time_tracking_projects`, `bamboohr_list_timesheet_entries`, `bamboohr_list_training_categories`, `bamboohr_list_training_types`, `bamboohr_list_users`, `bamboohr_list_webhooks`, `bamboohr_list_whos_out`, `bamboohr_reopen_goal`, `bamboohr_request_custom_report`, `bamboohr_update_applicant_status`, `bamboohr_update_company_file`, `bamboohr_update_employee`, `bamboohr_update_employee_dependent`, `bamboohr_update_employee_training_record`, `bamboohr_update_goal`, `bamboohr_update_hour_record`, `bamboohr_update_table_row`, `bamboohr_update_time_off_balance`, `bamboohr_update_time_off_request_status`, `bamboohr_update_webhook`, `bamboohr_upload_company_file`, `bamboohr_upload_employee_file`, `bamboohr_upload_employee_photo`
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="v2.0.0" description="13 Aug 2026">
  `breaking` `new-actions` `bug-fix`

  Standardized several action names and folded the duplicate company-report action into request\_custom\_report (breaking). Added time-tracking lookup actions (projects, tasks, breaks, shift differentials, holidays) and goal alignment options, corrected field types and validation, and fixed binary file downloads and goal milestone updates.

  <AccordionGroup>
    <Accordion title="Added · 15 new actions">
      `bamboohr_create_hour_record`, `bamboohr_create_project_task`, `bamboohr_get_changed_employee_ids`, `bamboohr_list_benefit_deduction_types`, `bamboohr_list_break_policies`, `bamboohr_list_break_policy_breaks`, `bamboohr_list_goal_alignment_options`, `bamboohr_list_holidays`, `bamboohr_list_list_fields`, `bamboohr_list_member_benefit_events`, `bamboohr_list_monitor_fields`, `bamboohr_list_project_tasks`, `bamboohr_list_shift_differentials`, `bamboohr_list_time_tracking_projects`, `bamboohr_list_whos_out`
    </Accordion>

    <Accordion title="Removed · 8 actions removed">
      `bamboohr_add_hour_record`, `bamboohr_get_benefit_deduction_types`, `bamboohr_get_changed_employees`, `bamboohr_get_company_report`, `bamboohr_get_list_field_details`, `bamboohr_get_member_benefit_events`, `bamboohr_get_monitor_fields`, `bamboohr_get_whos_out`
    </Accordion>

    <Accordion title="Changed · 92 actions updated">
      `bamboohr_assign_time_off_policies`, `bamboohr_clock_in_employee`, `bamboohr_clock_out_employee`, `bamboohr_close_goal`, `bamboohr_create_application_comment`, `bamboohr_create_candidate`, `bamboohr_create_company_file_category`, `bamboohr_create_employee`, `bamboohr_create_employee_dependent`, `bamboohr_create_employee_file_category`, `bamboohr_create_employee_training_record`, `bamboohr_create_goal`, `bamboohr_create_goal_comment`, `bamboohr_create_job_opening`, `bamboohr_create_or_update_clock_entries`, `bamboohr_create_or_update_hour_entries`, `bamboohr_create_or_update_list_values`, `bamboohr_create_table_row`, `bamboohr_create_time_off_history_item`, `bamboohr_create_time_off_request`, `bamboohr_create_time_tracking_project`, `bamboohr_create_training_category`, `bamboohr_create_training_type`, `bamboohr_create_webhook`, `bamboohr_delete_clock_entries`, `bamboohr_delete_company_file`, `bamboohr_delete_employee_training_record`, `bamboohr_delete_goal`, `bamboohr_delete_hour_entries`, `bamboohr_delete_hour_record`, `bamboohr_delete_table_row`, `bamboohr_delete_training_type`, `bamboohr_delete_webhook`, `bamboohr_estimate_future_time_off_balances`, `bamboohr_get_company_file`, `bamboohr_get_company_information`, `bamboohr_get_dataset_data`, `bamboohr_get_dataset_fields`, `bamboohr_get_employee`, `bamboohr_get_employee_file_categories`, `bamboohr_get_employee_photo`, `bamboohr_get_employee_table_rows`, `bamboohr_get_employee_time_off_policies`, `bamboohr_get_field_options`, `bamboohr_get_hour_record`, `bamboohr_get_job_application_details`, `bamboohr_get_report`, `bamboohr_get_states_by_country`, `bamboohr_get_webhook`, `bamboohr_get_webhook_logs`, `bamboohr_list_applicant_statuses`, `bamboohr_list_benefit_coverages`, `bamboohr_list_company_files`, `bamboohr_list_company_locations`, `bamboohr_list_countries`, `bamboohr_list_datasets`, `bamboohr_list_employee_dependents`, `bamboohr_list_employee_files`, `bamboohr_list_employee_trainings`, `bamboohr_list_employees`, `bamboohr_list_employees_directory`, `bamboohr_list_fields`, `bamboohr_list_goals`, `bamboohr_list_hiring_leads`, `bamboohr_list_job_applications`, `bamboohr_list_job_summaries`, `bamboohr_list_reports`, `bamboohr_list_tabular_fields`, `bamboohr_list_time_off_policies`, `bamboohr_list_time_off_requests`, `bamboohr_list_time_off_types`, `bamboohr_list_timesheet_entries`, `bamboohr_list_training_categories`, `bamboohr_list_training_types`, `bamboohr_list_users`, `bamboohr_list_webhooks`, `bamboohr_reopen_goal`, `bamboohr_request_custom_report`, `bamboohr_update_applicant_status`, `bamboohr_update_company_file`, `bamboohr_update_employee`, `bamboohr_update_employee_dependent`, `bamboohr_update_employee_training_record`, `bamboohr_update_goal`, `bamboohr_update_hour_record`, `bamboohr_update_table_row`, `bamboohr_update_time_off_balance`, `bamboohr_update_time_off_request_status`, `bamboohr_update_webhook`, `bamboohr_upload_company_file`, `bamboohr_upload_employee_file`, `bamboohr_upload_employee_photo`
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="v1.1.0" description="14 Jul 2026">
  `native webhooks`

  Added webhook event support for employee.created, employee.updated, and employee.deleted events with programmatic webhook registration.
</Update>