Prerequisites
Accessing ADP Workforce Now's API is not free.
To gain access, you will need to sign a statement of work, after which you will be assigned a representative from ADP to assist you with the setup.
This guide requires access to an ADP representative who can assist you in generating credentials.
Generating a certificate signing request
In addition to common client_id and client_secret credentials, ADP requires you to create a certificate for additional security.
After finishing the guide, you should have access to a keyfile (.key).
Receiving the remaining credentials from ADP
After creating the keyfile, you must send it to ADP along with your requested application scopes.
To obtain the application scopes, navigate to HiPeople and Log In. Click on your user name on the bottom left, and then Settings. Locate the Integrations option on the list on the left. (Direct link here: https://app.hipeople.io/settings/org/integrations).
On the Integrations page, locate and click ADP Workforce Now under the Automate in HiPeople (Pull Integration) category.
Review the list of actions/requirements, and click Continue.
Copy the list of scopes as provided in the connection flow:
Send your ADP representative a message asking for the remaining credentials:
Hey ______,
We are looking to set up an integration with HiPeople and would require your assistance in generating the remaining credentials.
I've attached the keyfile. Would you please be able to provide us with the corresponding certificate, client_id, and client_secret?
We would require the following scopes:
[ENTER THE SCOPES FROM YOUR CONNECTION FLOW HERE]
Once your representative responds, they should have shared the certificate, client_id, and client_secret with you. Paste them into the connection flow.
Note: If the certificate was shared with you as a file, you must open it in a text editor to copy the text into the connection flow.
What do test results look like in ADP Workforce Now?
Log in to your ADP Workforce Now instance.
Go to a candidate's "Profile" page.
Click on the "Assessments" tab:
The test result will be shown in the "Assessments" tab:
Now that your integration is live, you can either create jobs manually in HiPeople and link them to your existing ADP Workforce Now jobs, or turn on ATS Sync to have jobs created automatically in HiPeople whenever new ones are added in ADP Workforce Now. You can learn more about ATS Sync here.
For information on how to use the ATS automation and link specific Jobs in HiPeople to Jobs in ADP Workforce Now, check out this article: Integrating a job with your chosen ATS.
Additional resources
For additional help or troubleshooting not covered here, reach out to the HiPeople support team at support@hipeople.io.