Employment Hero connector
Back to the connector overview, authentication methods, and actions.
26 Sept 2026
improvementClarified 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.Changed · 3 actions updated
Changed · 3 actions updated
employmenthero_create_certification, employmenthero_list_work_sites, employmenthero_update_certification23 Sept 2026
bug-fixCreating 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.Changed · 3 actions updated
Changed · 3 actions updated
employmenthero_create_certification, employmenthero_get_organisation, employmenthero_update_certification21 Sept 2026
bug-fixFixed 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.Added · 1 new action
Added · 1 new action
employmenthero_create_employee_salary_versionChanged · 51 actions updated
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_files18 Sept 2026
guide description-fixImproved 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.10 Sept 2026
guideUpdated the OAuth 2.0 connection guides with verified Developer Portal steps and screenshots.9 Sept 2026
auth breakingOAuth2 authorization now uses PKCE, which Employment Hero requires from September 2026. Existing connections may need to be reconnected before then.Changed · 51 actions updated
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_files8 Sept 2026
new-featureEnabled 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.