Savant

This guide provides comprehensive instructions for setting up the ADP connector in Savant, enabling you to sync key workforce and payroll data from ADP systems into your data workflows. 

Read Data from ADP account (Prebuilt Schema and Querying options)

Write (Supported only for select objects)

- Read Data from ADP account (Prebuilt Schema and Querying options)
- Write (Supported only for select objects)

To use the ADP connector in Savant, the following are required:

An active ADP account (e.g., Workforce Now)

Administrative privileges to register and manage apps

ADP APIs provisioned for your account (see supported objects below)

- An active ADP account (e.g., Workforce Now)
- Access to the ADP Developer Portal
- Administrative privileges to register and manage apps
- ADP APIs provisioned for your account (see supported objects below)

Savant supports the below mentioned authentication with ADP

This step-by-step guide ensures you can efficiently set up your environment for optimal data integration.

<b>Step 1: </b>Register an Application in ADP Developer Portal

- App Name: e.g., <code>Savant ADP Connector</code>
- Redirect URI: <code>https://app.savantlabs.io/api/callback</code>

Under Product API Access, select the following APIs based on your integration requirements:

- <code>HR.v2</code>
- <code>Workers API</code>
- <code>Work Assignment API</code>
- <code>Work Schedules API</code>
- <code>Worker Management API</code>
- <code>Applicant Onboard V2 API</code>
- <code>Payroll Data Input API</code>
- <code>Payroll Output API</code>
- <code>Team Time Cards API</code>
- <code>Time Cards API</code>
- <code>Time Off Balances API</code>
- <code>Time Off Request API</code>
- <code>Validation Table Code List API</code>

After creation, note down the following credentials:

- Client ID
- Client Secret
- SSL Client Certificate (.pfx or .pem)
- Set a secure password when downloading the certificate — you will need it to authenticate.

- Log in to the ADP Developer Portal
- Navigate to My Apps &gt; Create App
- Complete the application form with:
  - App Name: e.g., <code>Savant ADP Connector</code>
  - Redirect URI: <code>https://app.savantlabs.io/api/callback</code>
- Under Product API Access, select the following APIs based on your integration requirements:
  - <code>HR.v2</code>
  - <code>Workers API</code>
  - <code>Work Assignment API</code>
  - <code>Work Schedules API</code>
  - <code>Worker Management API</code>
  - <code>Applicant Onboard V2 API</code>
  - <code>Payroll Data Input API</code>
  - <code>Payroll Output API</code>
  - <code>Team Time Cards API</code>
  - <code>Time Cards API</code>
  - <code>Time Off Balances API</code>
  - <code>Time Off Request API</code>
  - <code>Validation Table Code List API</code>
- Click Create App.
- After creation, note down the following credentials:
  - Client ID
  - Client Secret
  - SSL Client Certificate (.pfx or .pem)
  - Set a secure password when downloading the certificate — you will need it to authenticate.

Ensure that your ADP account is provisioned for these APIs. If any are unavailable, contact your ADP representative to enable access. Store the credentials securely. You’ll upload the certificate and enter the password during connector setup in Savant.

<b>Step 2:</b> Configure Permissions and Scopes

Ensure the following OAuth scopes are granted:

- Ensure the following OAuth scopes are granted:

Below are recommended scopes mapped to the APIs selected:

In Savant, go to Systems &gt; Add System.

Select the ADP connector, and click Next.

- Client ID
- Client Secret
- Base URL: usually <code>https://api.adp.com</code>
- Upload the SSL Client Certificate
- Enter the Certificate Password

After signing into ADP and granting access, you'll be redirected to Savant.

- In Savant, go to Systems &gt; Add System.
- Select the ADP connector, and click Next.
- Enter:
  - Client ID
  - Client Secret
  - Base URL: usually <code>https://api.adp.com</code>
  - Upload the SSL Client Certificate
  - Enter the Certificate Password
- Click Authenticate to initiate OAuth.
- After signing into ADP and granting access, you'll be redirected to Savant.

Ensure the redirect URI in ADP matches exactly with <code>https://app.savantlabs.io/api/callback</code>.

Make sure your ADP user has permission to authorize app access.

Confirm the appropriate API products and scopes are provisioned in the Developer Portal.

APIs enforce request limits. Use incremental syncs or contact support if you're ingesting large volumes.

Verify token scopes and that the selected APIs are available to your ADP account.

- Double-check the Client ID and Secret.
- Ensure the redirect URI in ADP matches exactly with <code>https://app.savantlabs.io/api/callback</code>.
- Make sure your ADP user has permission to authorize app access.
- Confirm the appropriate API products and scopes are provisioned in the Developer Portal.
- APIs enforce request limits. Use incremental syncs or contact support if you're ingesting large volumes.
- Verify token scopes and that the selected APIs are available to your ADP account.

ADP Connector

Savant App

Savant Help

Find answers and get help from Intercom Support and Community Experts

This site employs cookies and other technologies that we and our third party vendors use to monitor and record personal information about you and your interactions with the site (including content viewed, cursor movements, screen recordings, and chat contents) for the purposes described in our Cookie Policy. By continuing to visit our site, you agree to our {websiteTermsLink}, {privacyPolicyLink} and {cookiePolicyLink}.

This site uses cookies and similar technologies ("cookies") as strictly necessary for site operation. We and our partners also would like to set additional cookies to enable site performance analytics, functionality, advertising and social media features. See our {cookiePolicyLink} for details. You can change your cookie preferences in our Cookie Settings.

We use cookies to make our site work and also for analytics and advertising purposes. You can enable or disable optional cookies as desired. See our {cookiePolicyLink} for more details.

You have the right to opt out of the sale of your personal information. See our {cookiePolicyLink} for more details about how we use your data.

Your Privacy Choices

We use cookies to enhance your experience. You can customize your cookie preferences below. See our {cookiePolicyLink} for more details.

Cookie Settings

Link, Press control-option-right-arrow to exit

Empty Help Center

Uh oh. That page doesn’t exist.

Disappointed

Neutral

Smiley

Thinking...

Searching through sources...

Analyzing...

Tickets submitted through the messenger or by a support agent in your conversation will appear here.

API	Required OAuth Scopes
Workers API	`workers:read`
Work Assignment API	`workAssignments:read:write`
Work Schedules API	`workSchedules:read:write`
Worker Management API	`workerManagement:read:write`
Applicant Onboard V2 API	`applicantOnboard:read:write`
Payroll Data Input API	`payrollDataInput:read:write`
Payroll Output API	`payrollOutput:read`
Team Time Cards API	`teamTimeCards:read`
Time Cards API	`timeCards:read`
Time Off Balances API	`timeOffBalances:read`
Time Off Request API	`timeOffRequests:read`
Validation Table Code List API	`validationTables:read`
Organizations API (if used)	`organizations:read`

ADP Connector

Features

Requirements

Connection Methods

Troubleshooting