> ## 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. Administrator access to the platform, or access to the necessary modules via Permissions, is required to use Admin API scopes.
Select Actions to adjust the guide
Some actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.
Action
Scope(s)
Loading actions...
Dynamic Guide URL
Scopes Selected

          

            
Separator

Register an OAuth application

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

Sign in to your Employment Hero account.

The Employment Hero sign-in page with the Email field highlighted

Click your profile name in the top right corner and select Developer Portal from the menu.

The profile menu open with the Developer Portal item highlighted

On the API page, click Add Application.

The Developer Portal API page with the Add Application button highlighted

On the Add New Application screen, complete the Application Details fields.

  • Application Name: any name you choose — for example, `StackOne Integration`
  • Redirect URI: `https://api.stackone.com/connect/oauth2/employmenthero/callback`
The Add New Application form with the Application Name and Redirect URI fields highlighted
Enables actions: Archive Certification, Create Certification, Create Department, Create Employee Salary Version, Create Work Site, Delete Certification, Get Certification, Get Certification Polling Status, Get Employee, Get Employee Superannuation, Get Employee Tax Declaration, Get Form, Get Form Response, Get Leave Request, Get Leave Requests, Get Onboarding Polling Status, Get Organisation, Get Rostered Shift, Get Unavailability, List Certifications, List Contractor Job Histories, List Cost Centres, List Custom Fields, List Employee Bank Accounts, List Employee Certifications, List Employee Custom Fields, List Employee Documents, List Employee Emergency Contacts, List Employee Employment Histories, List Employee Pay Details, List Employee Payslips, List Employees, List Employing Entities, List Form Responses, List Forms, List Leave Categories, List Organisations, List Policies, List Rostered Shifts, List Team Employees, List Teams, List Timesheet Entries, List Unavailabilities, List Work Locations, List Work Sites, Onboard Employee, Quick Add Contractor, Quick Add Employee, Update Certification, Update Department, Upload Certification Files, Upload Employee Document

In the API Scopes section, enable the permissions this integration needs. Each resource has its own Read, Create, Update, and Delete toggles, and StackOne only calls the endpoints your scopes allow. Enable the following:

The API Scopes section with the Read scope selected for the Employees resource

Employment Hero locks an application's scopes the moment it is saved, so confirm the selection is complete before continuing.

  • Use the Search scopes... box to find a resource quickly — scope groups are named after the resource, so search for "employee" or "leave" to narrow the list.
  • Scopes cannot be changed after the application is saved. Adding one later means registering a new application and reconnecting the account, so enable everything the integration may need now rather than the minimum.
  • Read-only integrations can safely skip every Create, Update, and Delete toggle.

Click Continue to Review, check the Application Details and Selected Scopes, then click Create Application.

The Review Application Details screen with the Create Application button highlighted

On the Application Created Successfully! screen, use the Copy buttons to copy the Client ID and Client Secret. Store both securely for use later.

  • Store these credentials securely. Do not share your credentials.
  • Paste them into the Client ID and Client Secret fields in the StackOne Connector profile.
The API Credentials screen with the Copy buttons for Client ID and Client Secret highlighted
## Creating the StackOne Connector Profile To create the Connector Profile in StackOne for Employment Hero: Log in to StackOne, open [Connectors](https://app.stackone.com/connectors), and select Employment Hero.
  • Click Add Profile.
  • If the connector offers more than one authentication method, set the Auth Method filter to OAuth 2.0.
  • Select the actions, and any events, to enable for this Connector Profile.
  • Click Continue.
  • Select Authentication Type as OAuth 2.0.
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
  • Click Create Profile.
 Congratulations! The new Connector Profile now shows up on the connector page. If you created it as a project member rather than an admin, it starts disabled until a project admin enables it. You can now continue to Link Accounts for Employment Hero. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.