How to Connect and Configure Employment Hero

The SuperPath Employment Hero integration is a great way to connect your Employment Hero system to SuperPath to keep your people and teams in sync.

IMPORTANT: In order to connect your Employment Hero account to SuperPath please ensure you are on the correct Employment Hero plan that allows API access.

Once you have confirmed you have the correct Employment Hero plan. Follow the below steps to connect:

STEP 1: Configure the SuperPath App in Employment Hero

Navigate to the Developer Portal in Employment Hero. This can normally be found by clicking in your Avatar in the top right corner. In the menu select "Developer Portal" (see image below)




From here click Add Application and enter the following details and scope

Name:  SuperPath
RedirectURL:  https://app.superpath.io/auth/employment-hero
Scopes:
certifications:list
employees_certifications:list
employee_custom_fields:list
employees:list (both)
certifications:show
employees:show
teams:list
organisations:list
organisations:show

One you configure these above and create the app it will give you a ClientID and Client Secret. 

It is important you take a copy of these credentials as you will need to use them when connecting Employment Hero in SuperPath.  You will also need the company name which can be located here - https://secure.employmenthero.com/account

One you have configured the application and make a copy of the ClientId, Client Secret and the Company Name, it's time to configure the WebHooks

STEP 2: Setup Webhooks in Employment Hero

You will also need to set up webhooks so people changes can be synced into SuperPath.  In the same development portal you can click Webhooks in the left hand menu, the click "Add Webhook".

Add the following webhook with the information below. It's important that in the API URL you replace the account ID with your real account id. This can be found in the General Settings in SuperPath - https://app.superpath.io/settings#general

Name: SuperPath
URL: [*https://api.superpath.io/public/integrations/webhooks/**[accountId]**/employment-hero*](https://api.superpath.io/public/integrations/webhooks/kp9px7/employment-hero)
Events:
employee_created
employee_updated
employee_onboarded

STEP 3: Setup Employment Hero Integration in SuperPath

The final step is to configure the Employment Hero integration in SuperPath. Follow the steps below to configure.

Navigate to Integration Settings - https://app.superpath.io/settings#integrations
Select the Employment Hero Integration and click Connect
Select the user creation option. (see below)
Now enter the Company Name, Client Id and Client Secret that you saved from Step 1
Click Connect Employment Hero
Follow the prompts to authorise the application in Employment Hero


Once you are successfully completed you can run the Sync Teams or Trigger Full Sync to start to import users (based on selection).

User Creation Options

SuperPath offers 4 options for how to create users when connecting a HRIS platform
Manual - In this option users will NOT be created and will have to be created or invited manually. Once added the user records will be kept in sync through updates from Employment Hero
Invite Users - In this option users will be invited to the platform when triggered from Employment Hero. Users will only appear in SuperPath once they have accepted their invite. This is the option to use when wanting to use Google or MSFT SSO options
Create with Password - In this option the user will be created in SuperPath with a password. The user will not be notified. You can send a welcome email using the Send Welcome button in the People list which will send them their password. Alternatively they can use the forgotten password flow.
Create with Magic Link - In this option the user will be created in SuperPath with a magic link. The user will not be notified. You can send a welcome email using the Send Welcome button in the People list. This user will be able to access SuperPath using a magic link - https://help.superpath.io/en/article/how-to-login-using-magic-link-1ghozvh/

Updated on: 04/06/2025