> ## 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.

# Employment Hero Changelog

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

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

<Update label="v2.1.0" description="1 Oct 2026">
  `new-feature` `webhook`

  Added 45 webhook events for employees, bank accounts, employment histories, custom fields, leave requests, timesheet entries, certifications, employee certifications, custom form responses, goals and key results. Add the account's Native Webhook URL under Developer Portal > My Webhooks in Employment Hero (Platinum plan).
</Update>

<Update label="v2.0.5" description="26 Sept 2026">
  `improvement`

  Clarified certification and work site descriptions — certification names must be unique within the organisation, the county field is a free-text region label, and work sites (with their departments and HR positions) are separate from work locations.

  <AccordionGroup>
    <Accordion title="Changed · 3 actions updated">
      `employmenthero_create_certification`, `employmenthero_list_work_sites`, `employmenthero_update_certification`
    </Accordion>
  </AccordionGroup>
</Update>

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

  Creating or updating a certification now turns on approval automatically when approvers are given, and points to get\_organisation for the organisation's country, which decides whether state, county or territory applies.

  <AccordionGroup>
    <Accordion title="Changed · 3 actions updated">
      `employmenthero_create_certification`, `employmenthero_get_organisation`, `employmenthero_update_certification`
    </Accordion>
  </AccordionGroup>
</Update>

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

  Fixed certification and employee onboarding inputs that the Employment Hero API rejects — corrected the renewal period and salary period options, documented which regional field (state, county or territory) each country accepts, documented that approval and approvers must be set together, and corrected the certification attachment field to take file URLs.

  <AccordionGroup>
    <Accordion title="Added · 1 new action">
      `employmenthero_create_employee_salary_version`
    </Accordion>

    <Accordion title="Changed · 51 actions updated">
      `employmenthero_archive_certification`, `employmenthero_certification_polling_status`, `employmenthero_create_certification`, `employmenthero_create_department`, `employmenthero_create_employee_document`, `employmenthero_create_work_site`, `employmenthero_delete_certification`, `employmenthero_get_certification`, `employmenthero_get_employee`, `employmenthero_get_employee_superannuation`, `employmenthero_get_employee_tax_declaration`, `employmenthero_get_form`, `employmenthero_get_form_response`, `employmenthero_get_leave_request`, `employmenthero_get_leave_requests`, `employmenthero_get_organisation`, `employmenthero_get_rostered_shift`, `employmenthero_get_unavailability`, `employmenthero_list_certifications`, `employmenthero_list_contractor_job_histories`, `employmenthero_list_cost_centres`, `employmenthero_list_custom_fields`, `employmenthero_list_employee_bank_accounts`, `employmenthero_list_employee_certifications`, `employmenthero_list_employee_custom_fields`, `employmenthero_list_employee_documents`, `employmenthero_list_employee_emergency_contacts`, `employmenthero_list_employee_employment_histories`, `employmenthero_list_employee_pay_details`, `employmenthero_list_employee_payslips`, `employmenthero_list_employees`, `employmenthero_list_employing_entities`, `employmenthero_list_form_responses`, `employmenthero_list_forms`, `employmenthero_list_leave_categories`, `employmenthero_list_organisations`, `employmenthero_list_policies`, `employmenthero_list_rostered_shifts`, `employmenthero_list_team_employees`, `employmenthero_list_teams`, `employmenthero_list_timesheet_entries`, `employmenthero_list_unavailabilities`, `employmenthero_list_work_locations`, `employmenthero_list_work_sites`, `employmenthero_polling_onboard_employee`, `employmenthero_polling_onboard_result`, `employmenthero_quick_add_contractor`, `employmenthero_quick_add_employee`, `employmenthero_update_certification`, `employmenthero_update_department`, `employmenthero_upload_certification_files`
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="v2.0.2" description="18 Sept 2026">
  `guide` `description-fix`

  Improved the OAuth 2.0 connection guides — listed the specific API scopes to enable (the reads the connection test needs, full read coverage, and the writes each mutating action requires), clarified that the application name is an example rather than a fixed value, and corrected the Organisation ID section to retrieve the API organisation UUID from GET /api/v1/organisations instead of the platform ID in the web app URL. Replaced the Organisation ID placeholder with an example UUID.
</Update>

<Update label="v2.0.1" description="10 Sept 2026">
  `guide`

  Updated the OAuth 2.0 connection guides with verified Developer Portal steps and screenshots.
</Update>

<Update label="v2.0.0" description="9 Sept 2026">
  `auth` `breaking`

  OAuth2 authorization now uses PKCE, which Employment Hero requires from September 2026. Existing connections may need to be reconnected before then.

  <AccordionGroup>
    <Accordion title="Changed · 51 actions updated">
      `employmenthero_archive_certification`, `employmenthero_certification_polling_status`, `employmenthero_create_certification`, `employmenthero_create_department`, `employmenthero_create_employee_document`, `employmenthero_create_work_site`, `employmenthero_delete_certification`, `employmenthero_get_certification`, `employmenthero_get_employee`, `employmenthero_get_employee_superannuation`, `employmenthero_get_employee_tax_declaration`, `employmenthero_get_form`, `employmenthero_get_form_response`, `employmenthero_get_leave_request`, `employmenthero_get_leave_requests`, `employmenthero_get_organisation`, `employmenthero_get_rostered_shift`, `employmenthero_get_unavailability`, `employmenthero_list_certifications`, `employmenthero_list_contractor_job_histories`, `employmenthero_list_cost_centres`, `employmenthero_list_custom_fields`, `employmenthero_list_employee_bank_accounts`, `employmenthero_list_employee_certifications`, `employmenthero_list_employee_custom_fields`, `employmenthero_list_employee_documents`, `employmenthero_list_employee_emergency_contacts`, `employmenthero_list_employee_employment_histories`, `employmenthero_list_employee_pay_details`, `employmenthero_list_employee_payslips`, `employmenthero_list_employees`, `employmenthero_list_employing_entities`, `employmenthero_list_form_responses`, `employmenthero_list_forms`, `employmenthero_list_leave_categories`, `employmenthero_list_organisations`, `employmenthero_list_policies`, `employmenthero_list_rostered_shifts`, `employmenthero_list_team_employees`, `employmenthero_list_teams`, `employmenthero_list_timesheet_entries`, `employmenthero_list_unavailabilities`, `employmenthero_list_work_locations`, `employmenthero_list_work_sites`, `employmenthero_polling_onboard_employee`, `employmenthero_polling_onboard_result`, `employmenthero_quick_add_contractor`, `employmenthero_quick_add_employee`, `employmenthero_update_certification`, `employmenthero_update_department`, `employmenthero_upload_certification_files`
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="v1.1.0" description="8 Sept 2026">
  `new-feature`

  Enabled scheduled data sync on twelve list actions — employees, organisations, employing entities, work locations, work sites, teams, certifications, custom fields, cost centres, policies, leave categories and leave requests — so these collections can be kept in sync and searched without calling Employment Hero on every request. Each syncs by full refresh, because the Employment Hero API exposes no updated-since filter on any endpoint.
</Update>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.