> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-claude-issue-384-20260409-1436.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Employment Hero

> Follow these steps to connect Employment Hero via the StackOne Hub successfully.

<Warning>
  Ensure that your Employment Hero account has Admin privileges.
</Warning>

If you have been directed to StackOne to integrate with Employment Hero, the following steps will help you understand the process and any necessary actions to configure a successful integration.

## Find your Organization ID

Your Organization ID is a unique number located in your Employment Hero platform URL. You may need this ID when configuring your integration.

Look at the page URL in your browser's address bar. You will see a unique number which is your **organization's platform ID**.

For example, if your URL is `https://secure.employmenthero.com/app/organisations/12345/dashboard`, then your organization ID is `12345`.

## Generate Client ID and Secret key

<Steps>
  <Step title="Log in to your Employment Hero account">
    Log in to your Employment Hero account with Admin privileges to access the necessary settings for integration.
  </Step>

  <Step title="Navigate to Account > Developer Portal > API">
    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="Navigate to Account > Developer Portal > API" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/m1vQyc2kYu0irzJa/images/employmenthero/image1.png?fit=max&auto=format&n=m1vQyc2kYu0irzJa&q=85&s=1414271bbfbec1354effb35903417210" data-og-width="1914" width="1914" data-og-height="715" height="715" data-path="images/employmenthero/image1.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/m1vQyc2kYu0irzJa/images/employmenthero/image1.png?w=280&fit=max&auto=format&n=m1vQyc2kYu0irzJa&q=85&s=daf2cd92e3f21c6d4d045cdd5ec2cad9 280w, https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/m1vQyc2kYu0irzJa/images/employmenthero/image1.png?w=560&fit=max&auto=format&n=m1vQyc2kYu0irzJa&q=85&s=c174bd7fa130d41a3259a964ad39f38f 560w, https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/m1vQyc2kYu0irzJa/images/employmenthero/image1.png?w=840&fit=max&auto=format&n=m1vQyc2kYu0irzJa&q=85&s=47119c1ecab8c3fbfd1899fb345b0e34 840w, https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/m1vQyc2kYu0irzJa/images/employmenthero/image1.png?w=1100&fit=max&auto=format&n=m1vQyc2kYu0irzJa&q=85&s=e040f0a29785dc5e9eafc87cf50e423d 1100w, https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/m1vQyc2kYu0irzJa/images/employmenthero/image1.png?w=1650&fit=max&auto=format&n=m1vQyc2kYu0irzJa&q=85&s=f6d2d7ffb1f8b1c6c5c082d2de59658f 1650w, https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/m1vQyc2kYu0irzJa/images/employmenthero/image1.png?w=2500&fit=max&auto=format&n=m1vQyc2kYu0irzJa&q=85&s=4b03af324c05db5321c2e295998c982d 2500w" />
    </Frame>
  </Step>

  <Step title="Click Add Application">
    On the **API** tab, click the **Add Application** button.

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="Click Add Application" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/m1vQyc2kYu0irzJa/images/employmenthero/image2.png?fit=max&auto=format&n=m1vQyc2kYu0irzJa&q=85&s=7e36e863228a00836d79f051fddfab12" width="1652" height="375" data-path="images/employmenthero/image2.png" />
    </Frame>
  </Step>

  <Step title="Configure the App Details">
    Configure the app with the following details and then click the **Create** button

    * **Name**: e.g. StackOne
    * **Redirect URL**: `https://api.stackone.com/connect/oauth2/employmenthero/callback`
    * **Scopes**: Select the required admin and user scopes to enable data access via API. Below are the recommended scopes to select:
      * `custom_fields:list`
      * `employee_custom_fields:list`
      * `employees:list`
      * `timesheet_entries:list`
      * `leave_requests:list`
      * `policies:list`
      * `rostered_shifts:list`
      * `unavailabilities:list`
      * `bank_accounts:list`
      * `emergency_contacts:list`
      * `employment_histories:list`
      * `pay_details:list`
      * `teams:list`
      * `organisations:list`

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="Configure the App Details" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/m1vQyc2kYu0irzJa/images/employmenthero/image6.png?fit=max&auto=format&n=m1vQyc2kYu0irzJa&q=85&s=0e464581a4137fcd5297fc0cb9ad78ba" width="1189" height="6150" data-path="images/employmenthero/image6.png" />
    </Frame>

    Click the **Continue to Review** button to proceed to the next step.

    Review the details and ensure that you have selected the necessary scopes for your integration.

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="Configure the App Details" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/m1vQyc2kYu0irzJa/images/employmenthero/image7.png?fit=max&auto=format&n=m1vQyc2kYu0irzJa&q=85&s=1800230e691c72a76a5536c234a745ce" width="1205" height="1189" data-path="images/employmenthero/image7.png" />
    </Frame>

    Click the **Create Application** button to generate your Client ID and Client Secret.
  </Step>

  <Step title="Copy your Client ID and Client Secret">
    Copy your Client ID and Client Secret and store them safely for use in a later step.

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="Copy your Client ID and Client Secret" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/m1vQyc2kYu0irzJa/images/employmenthero/image8.png?fit=max&auto=format&n=m1vQyc2kYu0irzJa&q=85&s=5c738e6809e4389bc57a1d32e0492c1d" width="1205" height="852" data-path="images/employmenthero/image8.png" />
    </Frame>
  </Step>
</Steps>

## Connecting with StackOne

<Steps>
  <Step title="Enter Credentials">
    Upon reaching the Link Account page, enter the credentials from the previous steps, then click the **Connect** button to proceed.

    <Frame>
      <img className="rounded-md" style={{ margin:"0 auto",border:"1px solid #efefef" }} alt="Enter Credentials" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/m1vQyc2kYu0irzJa/images/employmenthero/image5.png?fit=max&auto=format&n=m1vQyc2kYu0irzJa&q=85&s=1eefc3a899029eb2531865ac39cbfc15" width="509" height="670" data-path="images/employmenthero/image5.png" />
    </Frame>
  </Step>
</Steps>

<br />

Congratulations, you're all set! If you face any issues with the steps mentioned above,
please contact us by emailing [integrations@stackone.com](mailto:integrations@stackone.com). We're always here to assist you!

## Useful Links

<Card title="API Reference" icon="link" href="https://developer.employmenthero.com/api-references/">
  [https://developer.employmenthero.com/api-references/](https://developer.employmenthero.com/api-references/)
</Card>
