Prerequisites
Before you begin, ensure you have the following requirements.
Verify Admin Access and Install ADP API Central
Admin privileges are required for ADP Marketplace, project creation, and certificate management.
- Confirm you have Admin privileges for your ADP Workforce Now account
- Purchase and install ADP API Central for ADP Workforce Now from the ADP Marketplace
Obtaining Client ID and Client Secret
Access credentials via the ADP API Central app in your ADP account.
Create a Project in ADP Central
Log in to ADP API Central to create your API project.
- Navigate to Projects in the left menu
- Click Create a Project
- Enter a project name and optional description
- Select the required use cases (at minimum, Worker Demographics & Pay Profile (Read/Write))
- After project creation, enable additional APIs via the API Discovery tool within the project as needed
- Click Create Project to complete
Generating Certificate Files
Generate certificate and private key files for secure mTLS authentication.
Generate Certificate
Follow the steps to generate a certificate signing request (CSR).
- Refer to ADP’s official guide for Generating a Certificate Signing Request
- Download and save the certificate (.pem) file and private key file
- Ensure full headers are included (e.g.,
-----BEGIN CERTIFICATE-----and-----END CERTIFICATE-----)
Copy Certificate and Private Key Contents
Prepare the certificate and private key values for the connection.
- Open both files in a text editor
- Copy the full contents of the certificate file including BEGIN and END markers
- Copy the full contents of the private key file including BEGIN and END markers
- Store these values securely for use later
Creating the StackOne Connector Profile
To create the Connector Profile in StackOne for ADP Workforce Now:Navigate to Connector Profiles
Create New Connector Profile
- Click + Connector Profile
- Search for and select ADP Workforce Now
- Select Type as OAuth 2.0
- Fill out the fields using details retrieved from your provider:
- Client ID
- Client Secret
- Client Certificate
- Private Key
- (Optional) Select Actions to be enabled for this Connector Profile
- Click Create profile