Do you use HR Works for your onboarding and other processes? With this integration, you'll be able to add your new hires to your HR Works account with a simple click.
Send new hires to HR Works
Have you just hired a new employee via Tellent Recruitee and want to forward the information to your HR Works account? Follow the instructions below:
1. Go to the hired candidate's profile. Click the three dots and select Send to HR Works in the dropdown menu.
2. Check the information, correct it if necessary, and click Send. You can also send additional fields by clicking Optional fields:
3. An HR Works badge will be added to the candidate's profile so you and your teammates can see if a profile has already been forwarded.
📌 Note: You can only send a profile to HR Works once.
4. You can find the forwarded candidate in HR Works in People > List:
Setting up the integration
Prerequisites
Before getting started, please carefully read the following to make sure you fulfill all requirements for the integration to work:
1. You are an admin of your HR Works instance, or an admin shared their access with you. This is necessary for retrieving the API credentials, as explained later in this guide.
2. Log in to your company's HR Works instance and navigate to the top-right corner of your screen. 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:
Find your API credentials
1. Log in to your HR Works instance (or that of the admin account that was shared with you).
2. On the sidebar, click on the "Basics" dropdown, n the options that just appeared, click on "Integrations."
3. Click on the tile "HR WORKS-API."
4. On the new page, click the button "New key pair."
5. Click the button "Download" that just appeared.
6. Your API credentials should have been downloaded as a .txt file by now.
💡 Tip: Open the file, and 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 do not contain "..."s.
7. Enter the credentials into the connection flow, and press continue.
8. Next, please make sure you have the right scopes selected for this integration. The connection flow will display the required scopes.
9. Now, in HRworks, select the key you just generated and check the required permissions at the bottom of the page, and press save.
📌 Note: This is just an example, your required scopes might look different!
10. Finally, click "Set up integration" in the connection flow.
Finally, click "Set up integration" in the connection flow
What data does Tellent Recruitee send to HR Works?
Required: First Name; Last Name; Start Date; Organization Unit;
Optional: Gender; Date of Birth; Nationality; Marital Status; Language;





