Skip to main content

Employment-Hero

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.
  1. 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.
  1. 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

InputTypeDescriptionDefault Value
api_keystringAPI Key.
organization_configidsarrayOrganization ID. Organization ID which could be found as result of organizations stream to be used in other substreams
employees_configidsarrayEmployees ID. Employees IDs in the given organisation found in employees stream for passing to sub-streams

Streams

Stream NamePrimary KeyPaginationSupports Full SyncSupports Incremental
organisationsidDefaultPaginator
employeesidDefaultPaginator
leave_requestsidDefaultPaginator
employee_certificationsidDefaultPaginator
pay_detailsidDefaultPaginator
teamsidDefaultPaginator
policiesidDefaultPaginator
certificationsidDefaultPaginator
custom_fieldsidDefaultPaginator
employee_custom_fieldsidDefaultPaginator

Changelog

Expand to review
VersionDatePRSubject
0.0.12024-09-2545888Initial release by @btkcodedev via Connector Builder