Skip to main content

How to: Integrate ADP Comprehensive Services with Thoropass

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

Written by Stephen Gentile

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

⚠️ Note: This is an assisted connection. Unlike most integrations, setup requires a multi-step authorization process involving your organization, Thoropass, and ADP. The connection will show an error or pending status while in progress. This is expected.


Before You Begin:

ADP Comprehensive Services does not allow external administrators to be added directly through the platform, even if you are already an admin in your account. Access must be granted by submitting a formal authorization form through your ADP Comprehensive representative.


Requirements:

  • A senior executive at your company must be available to sign the authorization form.

  • Your company's ADP company code(s) are required. If you don't have these, contact your ADP representative.

  • The contact name, email, and phone number of the senior executive signing the form.

  • Setup time: Approximately 7 days after ADP confirms setup of the external admin user.

  • Update frequency: ADP Comprehensive Services connection accounts update / refresh every 24 hours, thereafter.


Overview of the Process:

  1. You initiate the integration in Thoropass and open the connection wizard.

  2. A senior executive at your company signs the authorization form.

  3. Thoropass co-completes the form on their end.

  4. You forward the completed form to your ADP representative.

  5. ADP processes the request and activates the connection (~7 days).


Step 1: Initiate the Integration in Thoropass

  1. Log into the Thoropass App.

  2. Select Settings, then Integrations.

  3. Click +Browse Integrations.

  4. Search for or scroll to ADP Comprehensive Services, 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 connection wizard.

    • The wizard will display a Business Email address

    • Note this address, as it is required on the form.

⚠️ After completing the wizard, the connection will show an "error" status.

  • This is expected. The connection cannot activate until ADP processes the authorization form. Please do not delete or recreate the connection while it is pending.


Step 2: Complete the Authorization Form

A senior executive at your company must fill out and sign the form linked inside the Thoropass connection wizard.

Before starting, have the following ready:

  • Company's ADP company code(s)

  • Senior executive's contact name, email, and phone number

  • The Business Email displayed in the Thoropass connection wizard (this goes in the New User section on Page 1 of the form)

Filling the form:

  1. Complete all required fields.

  2. In the New User section, use the Business Email from the Thoropass connection wizard, not the senior executive's personal email. This is the address ADP will use to grant access to Thoropass.

  3. Once all required fields are filled in, click Finish to submit.

  4. Thoropass will automatically complete the remaining fields on their end.



Step 3: Confirm Completion in Thoropass

  1. Return to the Thoropass connection wizard.

  2. Check "I've read and completed the instructions".

  3. Click Complete.



Step 4: Forward the Completed Form to ADP

Once both parties have signed, you will receive the fully executed form via email from Thoropass.

  1. Forward that email (with the completed form attached) to your ADP representative.

  2. CC the Business Email from the Thoropass connection wizard on the forwarded email.

⚠️ Do not resubmit the form. Only forward the completed, co-signed form Thoropass sends back to you. Starting a new form will restart the process and cause delays.


Step 5: ADP Activates the Connection

ADP will process the authorization and set up the external admin user. This typically takes approximately 7 days.

  • The connection status in Thoropass will remain in an error or pending state during processing. No further action is needed on your end.

  • Once ADP confirms the setup, the connection status in Thoropass will update to Connected.


Troubleshooting:

The connection shows an error after I completed the wizard:
​This is expected for assisted connections. The error will clear once ADP processes the form and activates the connection.
​

I don't know my ADP company code:
​Contact your ADP Comprehensive representative or check your ADP administrator account settings.
​

It has been more than 7 days and the connection is still not active:
​Confirm with your ADP representative that they received the forwarded form and that it has been fully processed. Then contact your CSM/Support to verify the connection on our end.
​

I need the Business Email address again:
​Return to Settings > Integrations in Thoropass, find the pending ADP Comprehensive Services connection, and open it to retrieve the information.

Did this answer your question?