Skip to main content

ADP Integration Guide

Welcome to the ADP integration guide! This document walks you through how Pivot connects with ADP to streamline your payroll and employee management processes.

What is ADP Integration?​

ADP integration allows you to seamlessly connect your Pivot account with ADP's payroll and HR systems. This means you can:

  • Search and link employees from your ADP system directly in Pivot
  • Export payroll data from Pivot to ADP automatically
  • Synchronize employee information between both platforms
  • Authenticate users through ADP's secure login system

Setting Up ADP Integration​

1. Go to integration​

Go to your Account Settings and click on the "Integrations" tab. Find the ADP integration card in the Payroll Systems section.

Click the "Link" button on the ADP integration card. You'll be redirected to the ADP Marketplace to complete the subscription process.

3. Automatic Setup​

Once you complete the marketplace process, Pivot will automatically:

  • Store your ADP credentials securely
  • Fetch your employee list from ADP
  • Match existing Pivot employees with ADP employees
  • Set up the integration mapping

Searching for Employees​

When you need to link an employee to their ADP record:

1. Open the Employee Profile​

Navigate to the employee's profile in Pivot and click on the ADP ID field.

2. Search for the Employee​

Type at least 3 characters of the employee's name. The search is automatically debounced (waits 500ms) to avoid excessive API calls.

Choose the correct employee from the dropdown. The ADP ID will be automatically stored in the employee's record.

Tip: The search uses fuzzy matching, so you don't need to type the exact name - partial matches work great!

Exporting Payroll Data​

To send payroll data from Pivot to ADP:

1. Navigate to Payroll​

Go to your Payroll section in Pivot and prepare your payroll data as usual.

2. Export to ADP​

Click the "Export to ADP" button. Pivot will automatically format and send the data to ADP.

3. Verify in ADP​

Check your ADP system to confirm the data was received. The payroll data will be available for processing in ADP.

ADP Marketplace​

Subscribe​

Cancel​

Tip: This will remove all ADP employee mappings and integration settings. You can always reconnect later if needed.

User Authentication​

ADP Login Flow​

Employees can log in to Pivot using their ADP credentials:

1. Choose ADP Login​

On the login page, select "Login with ADP". You'll be redirected to ADP's secure login page.

2. Authenticate with ADP​

Enter your ADP username and password and authorize Pivot to access your information.

3. Return to Pivot​

You'll be automatically redirected back to Pivot and your account will be created or updated automatically.

Tip: All authentication happens through ADP's secure OAuth system, so Pivot never sees your ADP password.

API Endpoints Used​

Pivot communicates with ADP through these secure endpoints:

# Authentication
https://accounts.adp.com/auth/oauth/v2/token

# User Information
https://accounts.adp.com/core/v1/userinfo

# Employee Data
https://api.adp.com/hr/v2/workers

# Payroll Export
https://api.adp.com/events/payroll/v1/pay-data-input.modify

Troubleshoot​

If you're experiencing issues with the ADP integration:

1. Check Integration Status​

Go to Account Settings > Integrations and verify ADP shows as "Connected". Go to your ADP marketplace profile and check if you're linked to pivot.

2. ADP Support​

For ADP-specific issues, contact ADP support directly. They can help with marketplace subscriptions and API access.

Assistance​

If you need assistance with the ADP integration:

The ADP integration is designed to make your payroll and HR processes more efficient. With proper setup and regular maintenance, you'll enjoy seamless data flow between Pivot and ADP!