Connect ADP Workforce Now to Clarity

One connection replaces ongoing file management with secure data synchronization.

BEFORE YOU BEGIN

You will need administrator access to both ADP API Central and ADP Workforce Now.

Once permissions are saved, your data should begin syncing shortly.

Start Your Secure Connection

Open the secure link provided for your Clarity connection and authorize access.

Open the magic link provided, review the requested data access, and select Allow and Continue.

Select “Allow and Continue” to begin the connection.

WHAT HAPPENS NEXT?

You will be asked for an ADP Client ID and Client Secret. You will create these in ADP API Central in Step 2.

Connect Your ADP Account

Create an ADP API project, then copy your Client ID and Client Secret into the secure linking page.

Sign in to ADP API Central and select Create a Project.
Enter a project name and description, then continue.
For the use case, select Paid Time Off and create the project.

A. Create a project B. Name the project C. Select Paid Time Off (1/2) — A. Create a project B. Name the project C. Select Paid Time Off

IMPORTANT ADP SETTING

Do not rely on the Worker Demographics project alone. Make sure the v2/workers scope is added to the project so employee data can be accessed correctly.

Open the new project and copy the Client ID into the Clarity linking page.
Select Show Secret, then copy the Client Secret into the linking page.
Select Next.

A. Copy the Client ID B. Reveal and copy the Client Secret (2/2) — A. Copy the Client ID B. Reveal and copy the Client Secret

Authorize the Connection

Generate an ADP security certificate and add the certificate details to the linking page.

Return to ADP API Central and open Certificates and select Request Certificate.
Complete the required certificate information.
Copy the Private Key and save it securely on your computer, then paste it into the Clarity linking page.

A. Open Certificates B. Request a certificate C. Complete the certificate setup (1/2) — A. Open Certificates B. Request a certificate C. Complete the certificate setup

Continue in ADP to generate the certificate.
Select View, then copy the certificate. Download and store a copy for future reference.
Paste the certificate into the Clarity linking page and select Connect.

D. Copy the Private Key E. Generate and view the certificate F. Paste certificate details and connect (2/2) — D. Copy the Private Key E. Generate and view the certificate F. Paste certificate details and connect

KEEP BOTH ITEMS SECURE

Save the Private Key and certificate in a secure location for future reference.

Confirm Permissions

Give the ADP project the permissions required for the data that will sync to Clarity.

Sign in to ADP Workforce Now with administrator access.
Go to Setup > Access Permissions > Manage Profiles.
Find the API Central profile created for this connection, then open Menus & Features and assign the appropriate permissions.

A. Open Setup B. Access Permissions C. Manage Profiles D. Select the API Central profile

Sensitive Personal Information

Set the following permissions for the data that needs to sync:

Permission	Setting
Bank Account & Routing Masking	Partial masking with reveal and edit
Birth Date Masking	Partial masking with reveal and edit
Text ID Masking	Partial masking with reveal and edit
Accumulators Masking	No masking
Deduction Masking	No masking
Rate Masking	No masking with edit

E. Select the required Menus & Features F. Confirm the masking settings (2/4) — E. Select the required Menus & Features F. Confirm the masking settings

Save the permission settings.

You’re Connected

Your ADP Workforce Now connection is now established. Once the permission settings are saved, the data should begin syncing shortly.

NEED HELP?

If you receive a 403 Invalid Credentials or Permission message, use the troubleshooting steps below.

Troubleshooting

Only use this section if you receive a 403 Invalid Credentials or Permission error.

This error usually indicates that the required API scope or access has not been enabled for the client application.

Go to ADP API Central and open the relevant project.
Open the APIs tab and select Add APIs or Add More APIs.
Search for v2/workers and add the required worker API scopes.
Select Commit to Project to save your changes.
Return to the Clarity magic link and try connecting again.

A. Open the project B. Open APIs C. Add v2/workers scopes D. Commit to Project (4/4) — A. Open the project B. Open APIs C. Add v2/workers scopes D. Commit to Project