Employment Hero

Here's everything you need to know about integrating Employment Hero with Knit and making API calls

Integrating Employment Hero with the Knit UI component

To get started with using Employment Hero APIs, first you'll have to create an OAuth application inside Employment Hero

How to create OAuth app?

  1. Access the developer portal in to your Employment Hero account. The Developer Portal link is located in the menu under your profile name in the top right corner.

  2. Select the "Add Application" button and provide details about your app.

  3. Set the redirect URL to https://app.getknit.dev/oauth/authorize

  4. Select the following scopes:

    1. organisations:list
    2. organisations:show
    3. bank_accounts:list
    4. employees:list
    5. timesheet_entries:list
    6. employees:list
    7. employment_histories:list
    8. employees:show
    9. teams:list
  5. Click on "Save' and from this screen, copy the Client ID and Client Secret

Adding credentials in the Knit UI Component

Once you have your app credentials, you can use those to integrate with Employment Hero in the Knit UI Component

Enter the Client ID and Client Secret you got from above steps in the respective fields.

That's it! Click on submit, and if you've entered the correct credentials, you should be redirected to the Employment Hero login page, following which you will prompted to select the Organization for which you want to sync the data and then you should see that the Authorization has been successfully completed