Employment-Hero

Availability:

Airbyte Cloud Airbyte OSS PyAirbyte

Support Level:

Marketplace

Connector Version:

0.0.10(Last updated 4 days ago)

This directory contains the manifest-only connector for source-employment-hero.

Documentation reference:

Visit https://developer.employmenthero.com/api-references/#icon-book-open-introduction for API documentation

Authentication setup

Employement Hero uses Bearer token authentication, since code granted OAuth is not directly supported right now, Visit your developer profile for getting your OAuth keys. Refer https://secure.employmenthero.com/app/v2/organisations/xxxxx/developer_portal/api for more details.

Getting your bearer token via postman

You can make a POST request from Postman to exchange your OAuth credentials for an access token to make requests.

First make an app to get the client ID and secret for authentication:

1. Go to developers portal Page:

• Visit https://secure.employmenthero.com/app/v2/organisations/xxxxx/developer_portal/api, select Add Application and input an app name. Select the scopes and set the redirect URI as https://oauth.pstmn.io/v1/callback.

2. Copy Your App Credentials:

• After creating the app, you will see the Client ID and Client Secret.
• Client ID: Copy this value as it will be your Client ID in Postman.
• Client Secret: Copy this value as it will be your Client Secret in Postman.

3. Visit Postman via web or app and make a new request with following guidelines:

• Open a new request - Goto Authorization tab - Select OAuth 2.0
• Auth URL - https://oauth.employmenthero.com/oauth2/authorize
• Access Token URL - https://oauth.employmenthero.com/oauth2/token
• Set your client id and secret and leave scope and state as blank

Hit Get new Access token and approve via browser, Postman will collect a new access_token in the console response.

Configuration

Input	Type	Description	Default Value
api_key	string	API Key.
organization_configids	array	Organization ID. Organization ID which could be found as result of organizations stream to be used in other substreams
employees_configids	array	Employees ID. Employees IDs in the given organisation found in employees stream for passing to sub-streams

Streams

Stream Name	Primary Key	Pagination	Supports Full Sync	Supports Incremental
organisations	id	DefaultPaginator	✅	❌
employees	id	DefaultPaginator	✅	❌
leave_requests	id	DefaultPaginator	✅	❌
employee_certifications	id	DefaultPaginator	✅	❌
pay_details	id	DefaultPaginator	✅	❌
teams	id	DefaultPaginator	✅	❌
policies	id	DefaultPaginator	✅	❌
certifications	id	DefaultPaginator	✅	❌
custom_fields	id	DefaultPaginator	✅	❌
employee_custom_fields	id	DefaultPaginator	✅	❌

Reference

Config fields reference

Field

Type

Property name

API Key

required

string

api_key

array

organization_configids

array

employees_configids

Changelog

Expand to review

Version	Date	Pull Request	Subject
0.0.10	2025-01-25	52347	Update dependencies
0.0.9	2025-01-18	51681	Update dependencies
0.0.8	2025-01-11	51081	Update dependencies
0.0.7	2024-12-28	50526	Update dependencies
0.0.6	2024-12-21	50024	Update dependencies
0.0.5	2024-12-14	49489	Update dependencies
0.0.4	2024-12-12	49190	Update dependencies
0.0.3	2024-11-04	47819	Update dependencies
0.0.2	2024-10-28	47632	Update dependencies
0.0.1	2024-09-25	45888	Initial release by @btkcodedev via Connector Builder