Skip to main content
API access requires a Platinum subscription or above. Contact partner@employmenthero.com for a permanent sandbox.

​
Register an OAuth Application

Register an application in the Employment Hero Developer Portal to obtain OAuth credentials for API access.

1

Access the Developer Portal

Navigate to your Employment Hero organisation’s Developer Portal.

  • Go to Settings > Developer Portal > API in your Employment Hero account
  • Or navigate directly to https://secure.employmenthero.com/app/v2/organisations/{org_id}/developer_portal/api
2

Create a New Application

Click Add Application and fill in the application details.

  • Application name: Enter a name for your application (e.g., StackOne Integration)
  • Redirect URI: Enter https://api.stackone.com/connect/oauth2/employmenthero/callback
  • Scopes: Select the required scopes for your integration
  • Click Create to register the application
3

Copy Client Credentials

After creating your application, copy the Client ID and Client Secret from the application page and store them securely.

​
OAuth Authorization Requirements

Understand the token lifecycle for Employment Hero OAuth.

1

Token Expiry

Access tokens expire 15 minutes after creation. Refresh tokens do not expire but must be replaced with the new one returned on each refresh.

  • Access token lifetime is 15 minutes
  • Refresh tokens have no expiration
  • Always store the latest refresh token from each refresh response

​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Employment Hero:
1

Navigate to Connector Profiles

Login to StackOne and navigate to Connector Profiles
2

Create New Connector Profile

  • Click + Connector Profile
  • Search for and select Employment Hero
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile
Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for Employment Hero.