> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Employment Hero OAuth 2.0 connector profile – StackOne setup guide

> Set up the OAuth 2.0 connector profile for Employment Hero in StackOne. One-time admin setup required before your users can link Employment Hero accounts via Hub.

<Warning>API access requires a Platinum subscription or above. Contact [partner@employmenthero.com](mailto:partner@employmenthero.com) for a permanent sandbox.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Register an OAuth Application</h2>

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

  <Steps>
    <Step title="Access the Developer Portal">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Navigate to your Employment Hero organisation's Developer Portal.</p>

        <ul>
          <li>Go to <strong>Settings</strong> > <strong>Developer Portal</strong> > <strong>API</strong> in your Employment Hero account</li>
          <li>Or navigate directly to `https://secure.employmenthero.com/app/v2/organisations/{org_id}/developer_portal/api`</li>
        </ul>
      </div>
    </Step>

    <Step title="Create a New Application">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click <strong>Add Application</strong> and fill in the application details.</p>

        <ul>
          <li><strong>Application name</strong>: Enter a name for your application (e.g., StackOne Integration)</li>
          <li><strong>Redirect URI</strong>: Enter `https://api.stackone.com/connect/oauth2/employmenthero/callback`</li>
          <li><strong>Scopes</strong>: Select the required scopes for your integration</li>
          <li>Click <strong>Create</strong> to register the application</li>
        </ul>
      </div>
    </Step>

    <Step title="Copy Client Credentials">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>After creating your application, copy the <strong>Client ID</strong> and <strong>Client Secret</strong> from the application page and store them securely.</p>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>OAuth Authorization Requirements</h2>

  <p>Understand the token lifecycle for Employment Hero OAuth.</p>

  <Steps>
    <Step title="Token Expiry">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Access tokens expire 15 minutes after creation. Refresh tokens do not expire but must be replaced with the new one returned on each refresh.</p>

        <ul>
          <li>Access token lifetime is 15 minutes</li>
          <li>Refresh tokens have no expiration</li>
          <li>Always store the latest refresh token from each refresh response</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

## Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for <strong>Employment Hero</strong>:

<Steps>
  <Step title="Navigate to Connector Profiles">
    Login to StackOne and navigate to [Connector Profiles](https://app.stackone.com/connector_profiles)
  </Step>

  <Step title="Create New Connector Profile">
    <ul>
      <li>Click <strong>+ Connector Profile</strong></li>
      <li>Search for and select <strong>Employment Hero</strong></li>
      <li>Select <strong>Type</strong> as <strong>OAuth 2.0</strong></li>

      <li>
        Fill out the fields using details retrieved from your provider:

        <ul style={{ marginLeft: '20px' }}>
          <li><strong>Client ID</strong></li>
          <li><strong>Client Secret</strong></li>
        </ul>
      </li>

      <li>(Optional) Select <strong>Actions</strong> to be enabled for this Connector Profile</li>
      <li>Click <strong>Create profile</strong></li>
    </ul>
  </Step>
</Steps>

Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to <a href="/guides/accounts-section#linking-accounts">Link Accounts</a> for <strong>Employment Hero</strong>.