APIs & Integrations
Employment Hero
Overview
Pre-built tooling
✅ Authorization
✅ Authorization
✅ Read & write data
✅ Read & write data
| Tools | Status |
|---|---|
| Pre-built integrations | 🚫 (time to contribute: <48h) |
| API unification | ✅ |
| 2-way sync | ✅ |
| Webhooks from Nango on data modifications | ✅ |
| Real-time webhooks from 3rd-party API | 🚫 (time to contribute: <48h) |
| Proxy requests | ✅ |
✅ Observability & data quality
✅ Observability & data quality
| Tools | Status |
|---|---|
| HTTP request logging | ✅ |
| End-to-type type safety | ✅ |
| Data runtime validation | ✅ |
| OpenTelemetry export | ✅ |
| Slack alerts on errors | ✅ |
| Integration status API | ✅ |
✅ Customization
✅ Customization
| Tools | Status |
|---|---|
| Create or customize use-cases | ✅ |
| Pre-configured pagination | 🚫 (time to contribute: <48h) |
| Pre-configured rate-limit handling | 🚫 (time to contribute: <48h) |
| Per-customer configurations | ✅ |
Pre-built integrations
No pre-built integration yet (time to contribute: <48h)Not seeing the integration you need? Build your own independently.
Access requirements
| Pre-Requisites | Status | Comment |
|---|---|---|
| Paid dev account | ✅ Not required | Free, self-signup for an Employment Hero account. |
| Paid test account | ✅ Not required | Free, self-signup for an Employment Hero account. |
| Partnership | ✅ Not required | |
| App review | ✅ Not required | |
| Security audit | ✅ Not required |
Setup guide
1
Create an Employment Hero account
Go to Employment Hero signup page and create a free account. Once your account is created, you can access the Developer Dashboard.
2
Access the Developer Portal
- Log in to your Employment Hero account.
- Click on your profile from the top right corner then click Developer Portal.
3
Create a new app
- In the Developer Portal, navigate to the API page and click the Add Application button.
- Enter a Name for your app and set
https://api.nango.dev/oauth/callbackas the Redirect URI. - Select the required API scopes.
- Click Create to finalize your application.
- Once your application is created, a Client ID and Client Secret will be displayed. Copy these credentials, as you will need them when setting up the integration in Nango.
4
Next
Follow the Quickstart.
Need help getting started? Get help in the community.
Useful links
| Topic | Links |
|---|---|
| General | Website |
| Create an account | |
| Sign in to your account | |
| Developer | API documentation |
| Authentication documentation | |
| OAuth 2.0 guide | |
| How to register an application |
Contribute useful links by editing this page
Common Scopes
| Scope | Description |
|---|---|
| organisations:list | Read all organisations you belong to |
| organisations:show | Read organisations details |
| employees:list | Read all employees which belong to an organisation |
| teams:list | Read all teams which belong to an organisation |
| invoices:list | Read all invoices which belong to an organisation |
| payslips:list | Read all payslips which belong to an employee |
API gotchas
- The scopes used are the ones selected when creating a new application on the developer portal, so there is no need to supply scopes within Nango.
Contribute API gotchas by editing this page