Apideck CLI: Query 200+ SaaS APIs from your terminal. No SDK needed. Read more

Apideck Documentation Page

ADP Workforce Now – Connection Guide

Service ID: adp-workforce-now

The all-in-one platform for payroll and HR software, provides expert support and analytics for data-driven insights.

How to connect to ADP Workforce Now

This guide explains how to connect your ADP Workforce Now account through Vault.

Note: ADP Workforce Now is available in the US and Canada. Customers outside these regions (including the UK and Europe) should use ADP iHCM instead.

Prerequisites

To connect, you need ADP API credentials. These are obtained through ADP API Central, a paid add-on available on the ADP Marketplace.

Step 1: Purchase ADP API Central

  1. Go to the ADP Marketplace and purchase ADP API Central for ADP Workforce Now.
  2. Once purchased, ADP API Central will be activated in your ADP account within minutes.

Step 2: Create a project and generate credentials

  1. Log in to the ADP API Central portal.
  2. Click Projects in the left menu, then Create Project.
  3. Enter a project name and description.
  4. Select the appropriate use case (e.g., Employee Demographic Data).
  5. Click Create Project.

api central select usecase

api central create project

Step 3: Generate a TLS certificate

  1. In your project, click Manage Certificate.
  2. Follow the steps to generate a certificate.
  3. Download and save both the certificate file (.crt/.pem) and private key file (.key).

ADP API Central - Generate Certificate

TIP: Copy the full content of each file, including the -----BEGIN ...----- and -----END ...----- headers.

Step 4: Copy your Client ID and Client Secret

In your project's settings, you will find your Client ID and Client Secret. Copy both — you will need them in the next step.

ADP API Central - Copy Client ID and Secret

Step 5: Enter credentials in Vault

  1. You will receive a Vault connection link from the application you are connecting to.
  2. Open the link and select ADP Workforce Now.
  3. Enter the following:
    • Client ID: from Step 4
    • Client Secret: from Step 4
    • Client Certificate: paste the full content of the certificate file from Step 3
    • Client Key: paste the full content of the private key file from Step 3
  4. Click Save. The connection status should change to Connected.

Vault - ADP Workforce Now connection

Trouble Authenticating

If you are having trouble connecting:

  • Verify that your Client ID and Client Secret are correct.
  • Ensure the certificate and key content includes the full PEM headers (-----BEGIN ...----- and -----END ...-----).
  • Check that the use case selected in your ADP API Central project includes the required permissions.
  • Try regenerating your certificate in ADP API Central if the existing one has expired.
  • Contact ADP support for further assistance.