> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-docs-confluence-api-token-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ADP Workforce Now

> Follow these steps to connect ADP Workforce Now with StackOne Hub successfully.

<Warning>
  Ensure you have Admin privileges for your ADP Workforce Now account.
</Warning>

If you've been directed to StackOne to integrate with ADP Workforce Now, the following steps will help you understand the process and any necessary actions to configure successful integration.

## Prerequisites

Before you begin, ensure you have the following:

* **Admin Access**: Admin privileges are required for ADP Marketplace, project creation, and certificate management
* **ADP API Central App**: Purchase & Install "ADP API Central for ADP Workforce Now" from [https://apps.adp.com/en-US/apps/410612](https://apps.adp.com/en-US/apps/410612)

## Step 1: Obtaining Client ID and Client Secret

Access credentials via the ADP API Central app in your ADP account:

1. Log in to ADP Central at [https://api-central.adp.com](https://api-central.adp.com)
2. Navigate to **Projects** in the left menu
3. Click **Create a Project**

<Frame>
  <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Create Project" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/zHY41-o1JHEiZkNS/images/adpworkforcenow/image2.png?fit=max&auto=format&n=zHY41-o1JHEiZkNS&q=85&s=cb4c3da3006112868287cbac7c01fa3d" width="2461" height="461" data-path="images/adpworkforcenow/image2.png" />
</Frame>

4. Enter project name, description (optional).

<Frame>
  <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Project details" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/zHY41-o1JHEiZkNS/images/adpworkforcenow/image3.png?fit=max&auto=format&n=zHY41-o1JHEiZkNS&q=85&s=8c357cd653d18a30a2608b99a6c8cc34" width="990" height="903" data-path="images/adpworkforcenow/image3.png" />
</Frame>

5. Select the required use case(s) (minimum: Worker Demographics & Pay Profile (Read/Write))

<Frame>
  <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Use case selection" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/zHY41-o1JHEiZkNS/images/adpworkforcenow/image4.png?fit=max&auto=format&n=zHY41-o1JHEiZkNS&q=85&s=0672cb94a442577b7d1c286e60f1dfd9" width="946" height="1286" data-path="images/adpworkforcenow/image4.png" />
</Frame>

* After project creation, enable all additional required APIs via the API Discovery tool within the project

<Frame>
  <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Additional APIs" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/zHY41-o1JHEiZkNS/images/adpworkforcenow/image8.png?fit=max&auto=format&n=zHY41-o1JHEiZkNS&q=85&s=f2ca07e3ecbd231dbf8ca311488b3d6d" width="2492" height="1024" data-path="images/adpworkforcenow/image8.png" />
</Frame>

6. Click **Create Project**

<Frame>
  <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Project created" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/zHY41-o1JHEiZkNS/images/adpworkforcenow/image5.png?fit=max&auto=format&n=zHY41-o1JHEiZkNS&q=85&s=10dc1132835c6a4b0801ce4ce087a236" width="946" height="1286" data-path="images/adpworkforcenow/image5.png" />
</Frame>

7. In the project, go to **Credentials** tab
8. Copy your **Client ID** and **Client Secret**

<Frame>
  <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Credentials tab" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/zHY41-o1JHEiZkNS/images/adpworkforcenow/image7.png?fit=max&auto=format&n=zHY41-o1JHEiZkNS&q=85&s=99caa6647679d909c43e7187cd7680c5" width="1265" height="1083" data-path="images/adpworkforcenow/image7.png" />
</Frame>

## Step 2: Generating Certificate Files

Generate certificate/private key files for secure authentication:

1. In the ADP Central project, click **Manage Certificate**

<Frame>
  <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Manage Certificate" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/zHY41-o1JHEiZkNS/images/adpworkforcenow/image6.png?fit=max&auto=format&n=zHY41-o1JHEiZkNS&q=85&s=3d799ec50718f2922319d1f9c1cef569" width="1696" height="623" data-path="images/adpworkforcenow/image6.png" />
</Frame>

2. Follow the steps to generate a certificate. Refer to ADP's official guide: [Generating a Certificate Signing Request](https://developers.adp.com/learn/how-to-articles/generate-a-certificate-signing-request)
3. Download and save the certificate (.pem) and private key files
4. Ensure full headers are included like `-----BEGIN PRIVATE KEY-----` and `-----END PRIVATE KEY-----`

## Step 3: Connecting to StackOne

Complete the integration with the following steps:

1. Enter your **Client ID** and **Client Secret** from Step 1
2. Locate the certificate (.pem) issued by ADP and your private key file
3. Open both files in a text editor and copy their full contents
4. Paste the certificate content into the Certificate field and private key into the Private Key field in StackOne
5. Click the `Connect` button

<Frame>
  <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="StackOne Credentials" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/zHY41-o1JHEiZkNS/images/adpworkforcenow/image1.png?fit=max&auto=format&n=zHY41-o1JHEiZkNS&q=85&s=2b76ae03b183cc66f495e8fbb7e9b9a4" width="500" height="790" data-path="images/adpworkforcenow/image1.png" />
</Frame>

<br />

Congratulations, you're all set! If you face any issues with the steps mentioned above,
please contact us by emailing [integrations@stackone.com](mailto:integrations@stackone.com). We're always here to assist you!

## Useful Links

<Card title="ADP Marketplace App" icon="link" href="https://apps.adp.com/en-US/apps/410612/adp-api-central-for-adp-workforce-now-and-adp-workforce-now-next-generation/overview">
  ADP API Central Overview
</Card>

<Card title="CSR Guide" icon="link" href="https://developers.adp.com/learn/how-to-articles/generate-a-certificate-signing-request">
  Generate CSR
</Card>

<Card title="API Reference" icon="link" href="https://developers.adp.com/apis/api-explorer/hcm-offrg-wfn">
  API Reference
</Card>
