How to Authenticate

this guide explains how to create a connector with adp workforce now, generate a client id and secret, request a certificate, and set up permissions for the project pre requisites you will need admin access to adp api central and adp workforce now creating a connector with adp workforce now step 1 open the magic link provided this will lead to a linking page step 2 click on allow and continue generating client id and secret step 3 the page will prompt for a client id and secret to obtain these, navigate to api central step 4 sign in to api central and click on create a project step 5 provide an appropriate name and description for the project and click on next step 6 for use case selection, select appropriate use case as per your requirements, in this case check paid time off and click on create project please be advised that selecting the worker demographics project may result in irregular behavior and could lead to incorrect permissions regarding the flow of employee data step 7 once the project is created, click on view project step 8 scroll down, copy the client id, and paste it in the prompt step 9 click on show secret to reveal the client secret copy and paste it in the prompt step 10 click on next to proceed requesting adp certificate step 11 you will now be prompted to enter the adp certificate details to obtain these, return to api central step 12 navigate to the certificate section and click on request certificate step 13 enter the required details and click on next to proceed to generate a private key step 14 copy the private key and save it in your local machine for future reference paste the copied key in the prompt on the linking page step 15 click on next step 16 click on done once the certificate starts being generated step 17 click on view to see the certificate copy the certificate, download it, and store it locally for future reference paste the copied certificate in the provided prompt step 18 click on connect the connection should now be successfully established setting up permissions step 19 navigate to adp workforce now and log in admin access is required for this step step 20 go to the setup section and click on access permissions step 21 navigate to manage profiles and find the profile created in the step 5 step 22 go to menus & features and assign appropriate permissions uncheck those fields that are not required step 23 go to sensitive personal information and assign appropriate permissions unmask the details if you fields like bank account number, date of birth, salary rate etc set the following permissions for the necessary data to be synced \ bank account & routing masking partial masking with reveal and edit \ birth date masking partial masking with reveal and edit \ text id masking partial masking with reveal and edit \ accumulators masking no masking \ deduction masking no masking \ rate masking no masking with edit step 24 save these settings the data should start syncing shortly troubleshooting if you receive the following error 403 invalid credentials or permission, please try again with correct credentials this usually indicates that the required api scope/access has not been enabled for the client application how to resolve please follow the steps below to verify and enable the required api access go to api central open the relevant project navigate to the apis tab click add apis or add more apis search for v2/workers select the api scopes shown in the image and click add click commit to project to save the changes once this is done, try connecting again using the magic link