Set up the Employment Hero integration and get all your HR insights in Torii's dashboard.

Overview

Torii integrates with your Employment Hero account and syncs the Users': names, work emails, job titles, managers, teams, and employment statuses - including start and termination dates. Employment Hero uses a bring-your-own-app connection: you create an API application inside your own Employment Hero account and connect it to Torii with the Client ID and Client Secret it generates.

Prerequisites

• You will need administrator access to your Employment Hero account - the Developer Portal is only available to admins.

Get the Client ID and Client Secret

1. Sign in to Employment Hero as an admin, open the Developer Portal, select the API section, and click Add Application.
   

   

2. Under Application Details, enter an Application Name (for example Torii) and set the Redirect URI to exactly https://api.toriihq.com/api/auth/employmentHero/callback. It must match exactly, including https:// and no trailing slash.
   

   

3. Under API Scopes, in the Admin section find the Employees group and tick Read.
   

   

4. Scroll down to the User section, find the Organisations group and tick Read. These two Read permissions are all Torii needs.
   

   

5. Click Continue to Review, confirm the selected scopes, and click Create Application. Note: scopes cannot be changed after the app is created.
   

   

6. Copy the Client ID and Client Secret and keep them safe - you will paste them into Torii next. Treat the Client Secret like a password.
   

   

Connect Employment Hero integration to Torii

1. Go to the Integrations page, select the Employment Hero tile, and click Connect.
2. Enter an Account Name, then paste the Client ID and Client Secret from step 6 above.
   

   

3. Click Connect and approve the connection in Employment Hero. Torii returns you to the Integrations page and starts the first sync automatically.
4. Once the integration is connected and synced, it will display a green checkbox and show Users and Licenses as successfully synced.
   

   

Update the User Lifecycle settings

To make sure you get user lifecycle information in Torii, define Employment Hero as your HR management system.

1. Go to Settings >> Users & Employees and, under User lifecycle, click Manage sources.
2. Under Human Resource Management Systems, select Employment Hero. If Employment Hero is your only source for user management, make sure the other identity providers are unselected.
   

   

3. Click Preview changes, then Apply changes.

Q&A

Q: What should I enter in the "Account Name" field?

A: The Account Name field lets you distinguish between connected accounts. The value can be anything you choose. Use a unique Account Name for each account - connecting a different account with an Account Name that is already in use will overwrite the existing account's data.

Q: I get a "redirect_uri mismatch" error when approving the connection.

A: The Redirect URI in your Employment Hero app does not exactly match the one Torii uses. Re-check that it is https://api.toriihq.com/api/auth/employmentHero/callback, with no trailing slash.

Q: No employees appear, or I see a "missing permissions" error.

A: The app is likely missing one of the Read scopes. Because scopes cannot be edited after an app is created, create a new application with both the Employees (Admin) and Organisations (User) Read scopes selected, then reconnect in Torii using the new credentials.

Q: Do I need to configure PKCE?

A: No. Employment Hero requires PKCE for OAuth from 14 September 2026, and Torii's integration already uses it - no extra setup is needed on your side.