Skip to main content

HRworks HRIS: How do I link my account?

How to integrate your HRworks integration?

Written by Cara Benecke

Prerequisites

Before getting started, please carefully read the following to make sure you fulfill all requirements for the integration to work:

  • You are an admin of your HRworks instance or an admin shared their access with you. This is necessary for retrieving the API credentials as explained later in this guide
    1. Log into your company's HRworks instance, and navigate to the top right of your screen.
    2. Click on your profile picture.
    3. You should be able to see the "Switch to admin interface" tab. If you cannot see it, it means that you are not an admin in your company's HRworks instance:

    SCR-20240507-mebh.png

Find your API credentials

  1. Log into your HRworks instance (or that of the admin account that was shared with you)

  2. On the sidebar, click on the "Basics" dropdown

  3. In the options that just appeared, click on "Integrations"

  4. Click on the tile "HR WORKS-API"

  5. On the new page, click the button "New key pair"

    HRworks_generate_new_key_value_pair.png
  6. Click the button "Download" that just appeared

    HRworks_download_new_key_value_pair.png
  7. Your API credentials should have been downloaded by now as a .txt file

  8. Open the file.
    You should see the credentials in the format of

    Access Key:        bwdJ9...........kRhc Secret Access Key: XNN73f3/P.......................U9DoOnB6

    For security reasons parts of these credentials were redacted, real credentials have no "..." in them

  9. Enter the credentials into the connection flow, and press continue

  10. Next, please make sure you have the right scopes selected for this integration.

    The connection flow will display the required scopes



    Now, in HRworks, select the key you just generated and check the required permissions at the bottom of the page, and press save

    HRworks_find_scopes_settings.png


    This is just an example, your required scopes might look different!

  11. Finally, click "Set up integration" in the connection flow

Did this answer your question?