ZenotiHelp

Connect ADP Run for payroll

ZTZenoti Docs Team Updated September 5, 2026 5 min readGuide

The ADP Run integration exports payroll-ready data from Zenoti β€” hours worked, earnings, commissions, and deductions β€” to ADP Run for processing. Zenoti does not run the payroll itself; ADP does. This article covers the Zenoti-side configuration; payroll processing happens in ADP.


On this page


Before you begin

Permission: You need organization administrator access to configure payroll integrations.

  • You need an active ADP Run employer account with administrator access.
  • Complete the ADP-side prerequisites listed below.
  • ADP Run uses a multi-token OAuth model β€” if your organization connects more than one ADP Run account, each requires its own token.

External-system prerequisites (ADP side)

Prerequisite Owner Where it is done
Active ADP Run employer account ADP account representative ADP contract
Administrator credentials that can authorize third-party integrations ADP account administrator ADP Run admin console
Employee records in ADP with stable employee IDs Payroll administrator ADP Run employee management
Earning codes for regular hours, overtime, commission, and any deductions that Zenoti will export Payroll administrator ADP Run earning codes configuration
Service-account or token permissions cleared for use with Zenoti ADP account representative ADP Run account settings

For the exact ADP Run menu paths β€” which vary by ADP product version β€” refer to ADP's own administrator documentation.


Network requirements

Direction Protocol / port Purpose Who whitelists
Outbound from Zenoti to ADP Run API HTTPS (port 443) OAuth token exchange and payroll data submission Managed by Zenoti

Plain HTTP is not supported. ADP does not require inbound connectivity to your network; all calls are initiated from Zenoti.

[SOURCE GAP β€” PM VERIFY: whether ADP Run SFTP-based exports are still an option for Zenoti customers, or whether all current ADP Run connections use the REST API with OAuth only. Prior V1 documentation referenced both.]


Choose the provider and set the payroll frequency

  1. Select the center in the scope selector, then navigate to Configuration > Integrations > Integration Settings (the center-scope caption) and expand Payroll. The accordion appears once payroll integration is enabled for your organization.
  2. In Provider, under Select Your Integration Platform, select the ADP Run tile and select Continue. Until you do, the other panels show Choose a provider and click continue.
  3. In Configuration, under GENERAL, set Payroll Frequency: to the cadence of your ADP Run pay cycle.

Connect the ADP Run connector

Under ACCOUNT, Connector Subscription Type: offers two paths.

New β€” the panel reads Subscribe for Zenoti - ADP Run connector in ADP Marketplace leveraging the below encrypted code.

  1. Select Launch Subscription Wizard.
  2. Step 1 - Generate Encrypted Code: select Generate, copy the Encrypted Code, and select Next.
  3. Step 2 - Validate Encrypted Code in the Zenoti ADP Run Connector: in ADP Marketplace, subscribe to the Zenoti ADP Run connector and enter the code when the connector asks for it, then select Next (or Back to regenerate).
  4. Step 3 - Verify your integration status: select Verify Status. Zenoti shows Account Name, Account ID, Subscription ID, Subscription Status, Effective Date, Sync Start Date, and Parent Center, and reports Your subscription details are retrieved successfully.

Existing β€” the panel reads Configure your existing Zenoti ADP Run connector Subscription ID in the below field to link your account.

  1. Enter the Subscription ID and save. Zenoti reports Your ADP RUN credentials are successfully retrieved., or Please enter a valid Subscriber ID. / Your account is not configured at ADP RUN. if the ID is not recognized.
  2. Read the Subscription Status.

Then select Authorize (the panel points to the help document for assistance) and Verify Authorization. Zenoti confirms with Your account is saved successfully.

Each subscription belongs to a Parent Center. Organizations that run separate ADP Run employer accounts per region or legal entity create one subscription per account and assign the matching centers; confirm the model with your ADP representative before subscribing.


Map payroll codes

  1. Open Payroll Codes Mapping and select Sync (Retrieve Payroll Codes from ADP RUN for mapping). Zenoti confirms with Payroll codes are succesfully synced from ADP Run.
  2. For each Zenoti Commission Type, choose the ADP Payroll Code it posts to. Every code must be mapped: Make sure all the payroll codes are mapped before saving., and codes must be unique: Make sure you select unique payroll codes.
  3. Select Save. Zenoti confirms with Your mappings are saved successfully.

Map employees

  1. Open Employee Mapping and choose Auto (Clock ID) when Zenoti clock IDs equal the ADP employee IDs, or Manual to map by hand.
  2. For manual mapping, retrieve the employees (Retrieve Employees from ADP RUN for mapping; Zenoti confirms Employees are succesfully synced from ADP Run.) and, for each Zenoti Employee Code and Employee Name, choose the ADP employee. Choose Do Not Process for employees who should be skipped.
  3. Select Save. Zenoti rejects duplicates with Make sure you select unique employees.

Save the organization-level settings before mapping at a center; otherwise Zenoti reports Pease save the settings at organization.


Verify the integration

  1. Confirm Step 3 - Verify your integration status shows the subscription and Verify Authorization succeeds.
  2. From Employee Mapping, spot-check that a known Zenoti employee is mapped to the correct ADP employee.
  3. Open the payroll integration report, filter Status to All Statuses, and confirm the first batch shows Processed rather than Pending or Failed.
  4. Compare the Zenoti output to ADP's register for the period; the numbers should match. Fix any mapping discrepancy before the next live payroll cycle.

Handle setup failures

Failure mode User-visible symptom Resolution
Subscription not verified Step 3 - Verify your integration status shows no subscription. Re-run the wizard, select Verify Status, then Authorize and Verify Authorization.
Token scope insufficient Employee mapping loads but sync fails with a permission error. Ask ADP to grant the full payroll-export scope, then re-authorize.
Employee not found in ADP Mapping dropdown does not list the employee. Confirm the employee exists in ADP and has an active status before mapping in Zenoti.
Wrong token assigned to a center Employees appear under the wrong ADP employer. Reassign the correct token to the center on the ADP Run page.
Payroll code not mapped The batch rejects the rows of a commission type. Map the commission type to an ADP Payroll Code in Payroll Codes Mapping, or ask your ADP payroll administrator to add the missing code in ADP.

Tips

  • Verify employee mappings carefully before the first sync to avoid payroll discrepancies.
  • If you have multiple Zenoti organizations connected to separate ADP accounts, document which token serves which organization so future admins do not reassign them by mistake.
  • Run a test export with a small subset of employees against a historical pay period before exposing the live payroll cycle.

Was this article helpful?
Your feedback helps us improve our documentation.