Prerequisites
There are two ways to get your ADP credentials. Follow only the section that applies to you:
- Provider setup: your provider is an ADP Decidium Partner. ADP sends the credentials to your provider, and your provider forwards them to you. Before you start, contact your provider to confirm they have completed their ADP Decidium Partner setup.
- Self-service setup: you have access to ADP API Central. You create the credentials yourself.
For both setups, you need an ADP representative who can approve API access.
If you're not sure which applies, ask your provider before you start.
Provider Setup
Receiving Credentials from ADP
To receive credentials, send a request to your ADP representative along with the application scopes:
-
Copy the list of scopes provided in the connection flow:
Note: The scopes above are only an example. Share the scopes shown in your own connection flow with your representative.
-
Send your ADP representative an email asking for the credentials.
Hi ______,
We are looking to set up an integration with ______ and need your help getting credentials.
Could you please send us the client_id and client_secret?
We need the following scopes:
[ENTER THE SCOPES FROM YOUR CONNECTION FLOW HERE]Note: The ADP representative will send the client_id and client_secret to your provider. This is the expected process.
-
Once your provider forwards the credentials to you, open the connection flow and enter them in the client_id and client_secret fields.
Self-Service Setup
Receiving the Remaining Credentials from ADP
Follow this section only if you don't have a Private Key and certificate from ADP yet. If you already have them, skip to Setting the Scope for Your ADP Account.
- Generate a certificate signing request
In addition to common client_id and client_secret credentials, ADP requires you to create a certificate for additional security.
Please follow ADP's guide describing the manual process of generating a certificate.
After finishing the guide, you should have a Private Key file (.key). - Send your ADP representative a message asking for the remaining credentials:
Hi ______,
We are looking to set up an integration with ______ and need your help generating the remaining credentials.
I've attached the keyfile. Could you please send us the corresponding certificate, client_id, and client_secret?
Setting the Scope for Your ADP Account
-
Copy the list of scopes provided in the connection flow:
Note: The scopes above are only an example. Share the scopes shown in your own connection flow with your representative.
- Send your ADP representative an email asking them to set up the scopes.
Hi ______,
We are setting up an integration with ______ and need your help setting up the account.
We need the following scopes:
[ENTER THE SCOPES FROM YOUR CONNECTION FLOW HERE]
Linking your ADP account
Once your ADP representative responds, open the connection flow and enter the following credentials:
- Enter the Private Key and the certificate:
- Enter the client_id and client_secret: