ADP Workforce Now

To create a project in API Central:

1. Navigate to API Central at https://api-central.adp.com/projects and sign in.
    
2. Select Create a Project.
   
   
   _{Example image of API Central. Select the Create a project button.}
    

3. Enter an appropriate name and description for the project, then select Next.

   TIP! Note down the project name. You'll need it later to locate the matching profile in ADP Workforce Now's Access Permissions.

   
   
   _{Example image of Create new project. Enter the name and description for the project.}
    

4. Select the use case that matches your requirements.
   
   
   _{Example image of Create new project. Select a use case.}
    
5. Select Create Project.

To add v2/workers to the API list:

1. Log in to API Central.
    
2. Select View to open the relevant project.
    
3. Select the APIs tab.
    
4. Select Add APIs or Add More APIs.
   
   
   _{Example image of API Central. Select the APIs tab, then select the Add more APIs button.}
    
5. In the Search box, enter v2/workers.
   
   
   _{Example image of API Central. In the search box, enter v2/workers.}
    
6. Select Add against the required API scopes.
   
   
   _{Example image of API Central. Select Add against the API scopes.}
    
7. Select Commit to Project to save the changes.
   
   
   _{Example image of API Central. Select the Commit to Project button.}
    
8. Try connecting again.

To get your Client ID and Secret:

1. Once the project is created, select View Project.
   
   
   _{Example image of API Central. Select the View project button.}

   The project details are displayed. By default, the Credentials tab is selected.
    

2. Scroll down and copy the Client ID.
   
   
   _{Example image of API Central. Select the Copy client ID button.}
    

   NOTE: The Client ID in the screenshot are for example purposes only. Extract your own Client ID.
3. Enable Show Secret to reveal the client secret.
    

4. Select Copy client secret. 
   
   
   _{Example image of API Central. Select the Copy client secret button.}
    

   NOTE: The Client Secret in the screenshot are for example purposes only. Extract your own Client Secret.
   TIP! Record the Client ID and Client Secret securely. They are required for the integration.

To request an ADP certificate:

1. From the menu sidebar, select Certificate. 
    
2. Select Request certificate.
   
   
   _{Example image of API Central. Select the Request certificate button.}
   
   The Request new security certificate window is displayed.
   
   
   _{Example image of API Central showing Request new security certificate.}
    
3. Select Next.
    
4. Enter the required details.
    
5. Select Next.
    

6. Copy the Private key, including the Begin Private Key and End Private Key. 

   WARNING! You must include the -----BEGIN PRIVATE KEY----- and -----END PRIVATE KEY----- lines when copying the private key. Omitting them will prevent the connection from completing.

   
   
   _{Example image of API Central. Select the Copy button.}
   
   NOTE: The Private Key in the screenshot is for example purposes only. Extract your own Private Key.

   TIP! Copy the Private Key securely. This will be required for the integration.

7. Select NEXT.

   The NEXT button is enabled only after the Copy button is selected.
    

   
   _{Example image of API Central, the Generate Certificate window.}

To retrieve your certificate:

1. Once the certificate starts generating, select Done.
   
   
   _{Example image of API Central, the Generate Certificate window.}

   This closes the request wizard and returns you to the Certificates page.
   
   
   _{Example image of API Central. Certificates window, select the View or Download buttons.}
    

2. Select View to view the certificate. Select Copy to copy the certificate.
    

3. Select Download to save a local copy for future reference. 
    

   TIP! Keep the details securely. This will be required for the integration.

To connect to your HRIS to allow Exclaimer to synchronize user contact details:

1. From the drop-down list, select ADP Workforce Now.
    
2. Select Connect. 
   
   An authorization window is displayed.
   
   
   _{Example image in Exclaimer when trying to connect to the ADP Workforce Now system.} 
    
3. Select Allow and Continue.
    
4. Enter your Client ID and Client Secret.
   
   
   _{Example image in Exclaimer when trying to connect to the ADP Workforce Now system. Enter your Client ID and Client Secret.}
    
5. Select Continue.
    

6. Enter the Certificate details and Private Key (including the header and footer lines).

   WARNING! You must include the -----BEGIN PRIVATE KEY----- and -----END PRIVATE KEY----- lines when copying the private key. Omitting them will prevent the connection from completing.

   
   
   _{Example image in Exclaimer when trying to connect to the ADP Workforce Now system. Enter your certificate details and Private key.}
    

7. Select Connect to complete the integration between Exclaimer and ADP Workforce Now using Bindbee.
    

   WARNING! Keep the window open until the connection is complete. If you close it too soon, the connection may not finish setting up, and it may not appear as connected in Exclaimer.

    If you try to connect to the ADP Workforce Now again, you may see a message saying that the connector already exists. If this happens, raise a Support ticket so the team can assist you.
    

8. Once a connection is established, the status displays as Connected in Exclaimer.
   
   
   _{Once a connection is established with the ADP Workforce Now system, the Connected text is displayed within Exclaimer.}

To configure permissions so employee data can sync:

1. Log in to ADP Workforce Now.
    
2. Select the Setup menu, then within Security, select Access Permissions.
    
3. Select Manage Profiles. 
   
   
   _{Example image of the Access Permissions screen. Select the Manage Profiles button.} 
    
4. Find the profile created for your API Central project. You can do a search as well. 
    
5. Select the profile.
    
6. Select Menus And Features. Assign the appropriate permissions. Navigate through the tabular feature list and uncheck all fields that are not required.
   
   
   _{Example image showing the Menus and Features tab.}
    
7. Save these settings. 
   
   The data should start syncing shortly.

To re-connect to the ADP Workforce Now system:

1. Select Re-connect.

   A message is displayed that reconnecting will remove your existing connection to ADP Workforce Now, and any data will no longer be available, and a new connection flow will start automatically.
   
   
   _{Select OK to reconnect to the ADP Workforce Now system.}
    

2. Select OK to continue.

To disconnect from the ADP Workforce Now system:

1. Select Disconnect. This removes your connection and any synced data.

   A message is displayed that disconnecting will entirely remove your connection to ADP Workforce Now, and any data from the system will no longer be available.
   
   
   _{Select OK to disconnect from the ADP Workforce Now system.}
    

2. Select OK to continue.

ADP Workforce Now connectors automatically synchronize data on a predefined schedule.

To run a manual sync to immediately update employee data in Exclaimer:

1. Select Sync Now.
   
   
   _{Select Sync Now to start a manual sync.}

If you receive the following error:

This usually indicates that the required API scope/access has not been enabled for the client application. Complete Step 2: Add v2/workers to the API list, then try connecting again.

If the authorization window does not appear in Exclaimer:

• Ensure the following domains are allowlisted in your network or browser security tools: cdn.bindbee.dev and *.bindbee.dev.
• Verify that browser extensions or content blockers are not preventing the page from loading.
• Refresh the browser and try again.

If you try to connect to ADP Workforce Now again and see a message saying the connector already exists, raise a Support ticket so the team can assist you.

If a scheduled or manual sync does not complete successfully:

• Confirm the connection still shows as Connected in Exclaimer.
• Verify the Client ID, Client Secret, and certificate have not expired or been revoked in API Central.

If the connection to ADP Workforce Now fails during setup, verify that:

• The Client ID and Client Secret are entered correctly.
• The certificate and private key have not expired or been revoked in API Central.
• The private key includes the full header and footer lines (-----BEGIN PRIVATE KEY----- and -----END PRIVATE KEY-----).
• The required v2/workers API scope has been added to the project in API Central.
• The correct use case was selected when the project was created in API Central.

If the connection fails after entering your certificate details, check that the private key was copied in full.

When copying the private key in API Central, you must include the header and footer lines shown below the key value:

-----BEGIN PRIVATE KEY-----

-----END PRIVATE KEY-----

If these lines are missing, return to API Central, copy the private key again in full, and re-enter it in Exclaimer.