Employment Hero
Overview
Pre-built tooling
✅ Authorization
| Tools | Status |
|---|---|
| Pre-built authorization (OAuth) | ✅ |
| Credentials auto-refresh | ✅ |
| Auth parameters validation | ✅ |
| Pre-built authorization UI | ✅ |
| Custom authorization UI | ✅ |
| Expired credentials detection | ✅ |
✅ Read & write data
| Tools | Status |
|---|---|
| Pre-built integrations | 🚫 (time to contribute: <48h) |
| API unification | ✅ |
| 2-way sync | ✅ |
| Webhooks from Tenklo on data modifications | ✅ |
| Real-time webhooks from 3rd-party API | 🚫 (time to contribute: <48h) |
| Proxy requests | ✅ |
✅ Observability & data quality
| Tools | Status |
|---|---|
| HTTP request logging | ✅ |
| End-to-end type safety | ✅ |
| Data runtime validation | ✅ |
| OpenTelemetry export | ✅ |
| Slack alerts on errors | ✅ |
| Integration status API | ✅ |
✅ 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 | ✅ |
No pre-built syncs or actions available yet.
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
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.
- Log in to your Employment Hero account.
- Click on your profile from the top right corner then click Developer Portal.
- 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.tenklo.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 Tenklo.
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 Tenklo.
Contribute API gotchas by editing this page