Skip to main content

How to: Integrate ADP Run with Thoropass

Step-by-step guide to integrate your ADP Run account with Thoropass.

Written by Stephen Gentile

Before You Begin:

You must have Owner credentials in ADP Run. The Owner role is required to add new admin users. Regular admin accounts cannot complete this setup.
​

Not sure if you're on ADP Run? See here for help choosing the right integration - ADP Integrations: Which One Should I Use?

Steps to Connect:

Step 1: Automatic Connection via OAuth

  1. Log into the Thoropass App.

  2. Select Settings, then Integrations.

  3. Click +Browse Integrations.

  4. Search for or scroll to ADP Run, then click Learn More.

  5. Click Set Up Integration.

  6. Enter a name to identify the connection account, then click Save.

  7. Click Connect to open the ADP Run authorization window.

  8. Sign in with your ADP Run Owner credentials.

  9. Authorize the connection when prompted.

  10. Return to Thoropass. You will receive confirmation once the connection is active.
    ​

If the Automatic Connection Fails:

If you encounter an error during the OAuth login, you can set up the connection manually by adding a dedicated admin user in ADP Run, as outlined below.

Step 1: Add a New Admin User in ADP Run

  1. Log into ADP Run with your Owner credentials at run.adp.com.

  2. Navigate to Company > Add Users or Company > User Security, then click Add User.

  3. Fill in the user details as shown in the Thoropass connection window:

    • User ID

    • First Name

    • Last Name

    • Email

  4. For the Role, select Payroll Admin.

  5. Save to create the new user.

Step 2: Connect in Thoropass

  1. Return to the Thoropass connection window.

  2. Enter the credentials for the new admin user you just created.

  3. Click Connect to complete the authorization.

Troubleshooting:

I don't have Owner credentials.
​Owner credentials are required to create admin users in ADP Run. Contact the person in your organization who manages ADP Run access and ask them to complete this setup, or to grant you the Owner role temporarily.
​

I see an error after connecting.
​Confirm that the user was created with the Payroll Admin role. If a previous Thoropass/Finch admin user existed, delete it and recreate it using the values shown in the Thoropass connection window.
​

You see "Hang tight!" after the final step.
​This is expected for first-time connections — Thoropass is finalizing the setup on the backend. The connection will appear under Settings, Integrations once it completes.

Did this answer your question?