ADP Workforce Now documentation: API explorer
Important: Before integrating with ADP, you must purchase API access for your account. You may be asked to pay a one-time implementation fee and recurring monthly fees for API access. Contact ADP support for details.
A. Set up an ADP connection
Start establishing a connection to ADP Workforce Now in either of the following ways:
- From the Resources menu, select Connections. Then, click + Create connection at the top right.
– or – - While working in a new or existing integration, you can add an application to a flow simply by clicking Add source or Add destination/lookup.
In the resulting Application list, select ADP Workforce Now.

The Create connection pane opens with required and advanced settings.
B. Describe your ADP Workforce Now connection

Name (required): Provide a clear and distinguishable name. Throughout integrator.io imports and exports, you will have the option to choose this new connection, and a unique identifier will prove helpful later when selecting among a list of connections that you’ve created.
Application (required, non-editable): A reminder of the app you’re editing.
C. Supply required ADP Workforce Now account information
At this point, you’re presented with settings for providing ADP Workforce Now authentication via SSL:

Account type (required): Select either of the following ADP accounts, depending on the access level provided when you signed up:
- Production – your live production environment
- UAT – a sandbox environment for user-acceptance testing
Client ID (required): Generate a certificate signing request (CSR) file and send it to your ADP representative to receive the Client ID and client secret to enter for your connection.
Client secret (required): Generate a CSR file and send it to your ADP representative to receive the client ID and Client secret to enter for your connection. Multiple layers of protection are in place, including AES 256 encryption, to keep your connection’s secret safe. When editing this form later, you must enter this value again; it is stored only when the connection is saved and never displayed as text.
SSL certificate (optional): Generate a CSR file and send it to your ADP representative to receive the PEM certificate file to upload to this setting.
SSL client key (optional): Generate a KEY file and upload it to this setting.
SSL passphrase (optional): You can set a password or phrase for your SSL certificate and key (when combined, known as a PKCS12) for additional security.
SSL connections to ADP require you to install OpenSSL Light and modify the system variables for your OS. Since Mac operating systems currently support an older version of OpenSSL (LibreSSL), Celigo recommends installing Homebrew instead.
Mac uses bash shell, so you can add environment variables to your .bash_profile file. Verify that these files are visible on your machine.
Tip: At the end of the file, you may see export command lines. If so, add these environment variables here. If not, just add them at the end of the file.
- Enter the following command:
export PATH="/usr/local/opt/openssl/bin:$PATH”
- Restart the terminal, then enter the following command:
source ~/.bash_profile
- Check that your OpenSSL version has been updated with the following command:
openssl version
- To generate the KEY file, enter this one-line command:
openssl genrsa -out yourcompanynamehere_auth.key 2048
Replace yourcompanynamehere with your company’s name. - To generate the CSR file, enter the following one-line command:
openssl req -new -key yourcompanynamehere_auth.key -out yourcompanynamehere_auth.csr
Replace yourcompanynamehere with your company’s name.
Email the CSR file to your ADP representative. After ADP gets your file, they will send you your client ID and client secret. The connection sends your client ID as proof that an authorized person wants to establish a connection between ADP and integrator.io.
SSL connections to ADP require you to install OpenSSL Light and modify the system variables for your OS. Use the following steps to add the OPENSSL_CONF variable to your system variables.
- Click the Windows Start button and search for “Edit the system environmental variables.”
- Click Edit the System environment variables.
- The System Properties window opens to the Advanced tab. Click the Environment Variables... button in the lower right corner of the window.
- In the System variables section, click New....
- Type
OPENSSL_CONF
in the Variable name field. - Type
c:\OpenSSL-Win32\bin\openssl.cfg
in the Variable value field. - Click OK.
Next, edit the file openssl.cfg:
- In your file system, open openssl.cfg.
- In the [req_attributes] section, delete
unstructuredName = An optional company name
.
Open a command prompt and change the directory to c:\OpenSSL-Win32\bin to create the files:
- To generate the KEY file, type this one-line command:
openssl genrsa -out yourcompanynamehere_auth.key 2048
Replaceyourcompanynamehere
with your company’s name. - To generate the CSR file, use this one-line command:
openssl req -new -key yourcompanynamehere_auth.key -out yourcompanynamehere_auth.csr
Replaceyourcomanynamehere
with your company’s name.
Email the CSR file to your ADP representative. After ADP gets your file, they will send you your client ID and client secret. The connection sends your client ID as proof that an authorized person wants to establish a connection between ADP and integrator.io.
D. Edit advanced ADP Workforce Now settings
Before continuing, you have the opportunity to provide additional configuration information, if needed, for the ADP Workforce Now connection.

Borrow concurrency from (optional): Select another connection from the list....
Concurrency level (optional): Up to 25 allowed....
E. Test the connection
Once you have configured the ADP Workforce Now connection, you have a few options for continuing:
- Save – click this button to test the connection, commit the new connection so that it will be available to all integrations for your account
- Save & close – click to test and save the connection and exit the Create connection pane
- Cancel – click to exit without saving any new changes
- Test connection – click this button to verify that your new connection is free of errors
When you test or save the connection, it is verified before continuing.

The new connection is now successfully added to your account. It will be applied to the current source or destination app, if you created it within a flow. Otherwise, you may proceed to register the connection with an integration.
Comments
1 comment
Very helpful article. Thank you for creating this. One quick comment - the link to OpenSSL points to the OpenSSL website but I could not find a download file for Windows here. All libs are for Linux.
I had to refer to this article here - https://stackoverflow.com/questions/50625283/how-to-install-openssl-in-windows-10. It says openssl comes packaged with a Git distribution, so I just used this for my work
Please sign in to leave a comment.