ADP - Practitioner Role Authentication

Linking ADP Workforce Now account using Practitioner Role

Collin Peterson avatar
Written by Collin Peterson
Updated over a week ago

This article is intended for HelloTeam users with ADMIN Access Level


How to create service account with a Practitioner Role that has permission to fetch Reports from your ADP instance.

Step One: Create a profile with access to reports

In your ADP Workforce Now account, go to Setup and find Access Permissions. Then go to Manage Profiles and click Create Profile and fill in the following fields:


Step Two: Give your service account access to securely sync your data

1. In Menus & Features, go to Reports & Analytics to make sure the following boxes in are checked:

Required Fields in My Reports:

  • All Reports

  • My Standard Reports

Required Fields in View:

  • Reports Output

  • Reports Scheduled

Required Fields in Reports Dashboard:

  • Reports Dashboard

Required Fields in Standard Reports:

  • All Reports - only grants access to report types that are otherwise checked

  • Personal & Employment

Recommended Fields in Standard Reports:

  • Benefits - optional, check this box if you want the integration to sync Benefits data

  • Pay Statement History - optional, check this box if you want the integration to sync Pay data

  • Time Off - optional, check this box if you want the integration to sync Time Off data

2. Next, go to People and make sure these boxes are checked off:

Required:

  • Employee Profile Report

  • Employment Profile

  • Personal Profile

  • OPTIONAL: If you need Payroll data, select Pay at the top

Recommended:

  • All People permissions: Click SELECT ALL in the top left. This will allow the integration to sync data pertaining to Time Off, Time and Attendance, Payroll, and Benefits information

3. (OPTIONAL FOR CERTAIN USE CASES) In Sensitive Personal Information, go to On Screen & Reports and On Reports, and from the drop down menu select No Masking, Partial Masking, or Masking. This will allow the service account to securely sync your complete data set:

If you do not want to sync over information such as Birthdate, SSN, or Bank Info, please Mask this information!

4. On the last screen, Status & Save, activate the profile, and then save it below:


Step Three: Create a new user and assign it to your "Integrations Service Account" profile.

1. From the Setup menu, select Security Management.

2. In Security Management, click People, then Manage Users and + to add a user.

3. Fill in the fields on the Add a New User page, using the fields displayed to you in the linking flow. See an example below:

Click Continue.

4. In Step 1 "User Information", set the User Type to the “user is an independent contractor...” option, and set the User Role to “Product User”.

5. In Step 2 "Services":

  • Assign the profile by selecting WFNPractitioner in the "Available Service Profiles Box" and moving it to the "Selected Service Profiles"

6. Proceed through Step 3, and confirm the new user.

Please note that a Username will be Auto-Generated for this person. That is completely okay and expected!


Step Four: Connect the Service Account User to the Service Account Profile

1. Go back to your Workforce Now portal, and go to the Access Permissions page like before to find the Manage People page. Search for Service Account to pull up the new user (that should be its last name).

2. Click the user to pull up User Access Permissions, and select Manage Profile Memberships. Add the Service Account Profile that you created to the user.
Click Save.

3. Now that the Service User has the right Profile associated, verify that the Menus & Features and Sensitive Personal Information for this user match what you set up in the Profile earlier (Step One).

4. Lastly, in People Access, under Service Account Currently Has, check off View Only Access to all People. Click View List of Selected People, and make sure that list is not empty.


Return to your Linking Flow and Authenticate!

When that is all completed, return to the linking flow, and click Submit. You should see a success message indicating your integration is all set. If the service account needs modification, you will be instructed to try again, with the same account values displayed to you!


Trouble Authenticating?

Our recommendation is to delete the created User, and restart the process from Step Three. ADP often can run into issues when updating the information of the prior service user, so we recommend starting from scratch.


To ensure you are viewing the most current information
regarding this specific HRIS, please visit:

Did this answer your question?