Do you use ADP Workforce Now and wish there was a way to automatically onboard your new hires into ADP?

We’ve got great news for you: Enboarder integrates with ADP to do exactly that!

Every time a new hire completes their details in Enboarder, the data can now be pushed seamlessly to ADP to automatically create an employee profile. And thanks to our two-way integration the data will remain up to date in both systems whenever changes are made from either side.

Goodbye manual data entry, hello streamlined onboarding process!

Before you begin: Like anything worth doing, integrations take time. Please allow up to 4 weeks for this integration to be completed, this includes time for scoping, development and testing. You’ll also need to have a system expert and/or system administrator to assist in the completion of this integration.

IMPORTANT NOTE: This connector is priced at USD$30/month, invoiced by ADP.

Introduction

This document outlines the main steps to Integrate ADP with Enboarder. Enboarder Data connector App is published in the ADP marketplace. Enboarder interacts with ADP via this APP to create/update workers in ADP as well as sync employee names/contacts with Enboarder.

System Supported

Currently, only the US region is supported. Therefore, the ADP integration tile will be available for the US server only. Please speak to your Customer Success Manager for more information on this.

System	Version	Region
ADP	ADP Workforce Now	US
Enboarder	4.22	US

User Access required

Here is a list of users in the system who need to be involved in the ADP integration setup.

System	Role Required
ADP	Admin user, HR Practitioner
Enboarder	Super Admin user

High-level Flow

Enboarder Integration Set up

Here are the steps for setting up the Integration:

Login to Enboarder as an admin user and go to Settings → Apps & Integrations
Click on the tile for ADP (or search if you can't see it) for which you want the integration setup.

Click on the Add Integration button

On the next screen, Please note down the Account ID. This is required when you install the Enboarder App from the ADP marketplace.

Once you have noted down the Account ID, please click on the Integrate Now button. The system will show the ADP tile in a pending state.

The next step is to log in to your ADP instance and install the Enboarder App.

Install Enboarder APP from ADP Marketplace

Login in to your ADP instance and go to the marketplace
Search for Enboarder App and click on the Subscription button to select it
Please click on the continue button on the next screen

On the Next screen, Please enter your Enboarder Account ID which you have noted from the Enboarder integration tile step previously. Then click on the "check" button.

The system will validate the Account ID and if it is valid, it will enable the continue button to be clicked.
In case of an error, please check the value of your account ID, it should be the same as shown in the Enboarder system.

Next is a confirmation screen as shown. Please click on the Place Order button.

The subscription is completed, your ADP admin user will also got an order receipt in email as well.

The app is now installed in your ADP instance marketplace.

Provide consent for Enboarder App

The ADP Admin user will get one more email with the subject "connection request" similar to the below screenshot. Please click on the View Request link in this email to provide your consent.

The link will open in the browser and ask the user to login to ADP, in case the user is not already logged in.

On the next screen, a consent page will be shown. Please click on the Allow button to provide your consent.

Again go back to the Enboarder Integration page
Click on the ADP tile
Click on the Update Integration button

Click on the Update Integration button again to provide/verify consent for Enboarder App.

The system will redirect the user to the ADP consent site. If consent is already given from the previous email then it will redirect you back to Enboarder immediately. Otherwise, ADP will ask you to provide your consent at this time.
The system will redirect you to the Enboarder site and show the ADP tile as integrated.

Webhook Set Up for create/update worker in ADP

Create worker

Special Custom fields for ADP Web-hook

Please refer or use these two files to set template code and company code. These values are required by Create Worker Template

Once the connection is successful and tile is integrated, the system creates additional two custom fields

ADP_Company_Codes - This list contains all company codes associated with ADP account
ADP_Templates_Codes - This list contains all the template codes created for US region

Please add these fields to the Workflow and select the value from the list while launching a Workflow.

Additional permission for the selected template

Please must ensure that Enable Marketplace Data connector profile permission is enabled for selected template

In order to use any ADP template for creating worker in ADP, Please ensure that below permission is given to template.

Setup > Template Management > Hire/Rehire > "{{Your Template }}" > Assign Users > Enable Marketplace Data connector profile > Save this.

Create worker

Using the Enboarder ADP Data connector, we can create a worker in real-time by configuring a webhook module in Enboarer and adding it in any workflow sequence as shown below.

The system will create the new worker as IN-PROGRESS State. ADP HR users need to go ADP home page → Process → HR → Hire/Rehire → In-Progress Hires to finalize the new worker record.

URL - https://enboarder-adp/integration/createworker
Authentication - Please select ADP from the list.
Method - POST

Payload - Please add the payload sample below to your webhook and make sure the keys and dynamic tokens are matching as per the mapping table below.

{
  "templateName": "{{templateName}}",
  "payroll": {
    "companyCode": "{{companyCode}}"
  },
  "personal": {
    "firstName": "{{firstname}}",
    "lastName": "{{lastname}}",
    "birthDate": "{{birthdate}}",
    "gender": "{{Gender}}",
    "legalAddress": {
      "lineOne": "{{address/line1}}",
      "lineTwo": "{{address/line2}}",
      "lineThree": "{{address/line3}}",
      "cityName": "{{address/city}}",
      "subdivisionCode": {
                    "subdivisionCode: {
                     "code":"State code"
                     },
      "countryCode": "{{address/countrycode}}",
      "postalCode": "{{address/postalcode}}"
    }
  },
  "employment": {
    "hireDate": "{{startdt}}",
    "reportTo": "{{reportTo}}",
    "email": "{{email}}",
    "mobile": "{{mobile}}"
  }
}

Field Mapping

Key	Value	Additional Comments
{{templateName}}	Name of template defined in ADP	ADP home page → Process → HR → Hire/Rehire → Go to Hire → United States → All templates. Please put the same name in Enboarder.
{{companyCode}}	company code	The ADP company code where you want to add the employee.
{{newhire_firstname}}	First name of the worker	Either from ATS or adding in Enboarder manually
{{newhire_lastname}}	Last name of the worker	Either from ATS or adding in Enboarder manually
{{birthdate}}	Birthdate	Either from ATS or adding in Enboarder manually
{{gender}}	Gender	Possible values "M" or "F"
{{Address}}	Address of worker	Either from ATS or adding in Enboarder manually
{{startdt}}	hire date of the worker	Either from ATS or adding in Enboarder manually
{{email}}	email	Either from ATS or adding in Enboarder manually
{{mobile}}	mobile	Either from ATS or adding in Enboarder manually
{{report To}}	position ID of the manager	Please copy position ID from Employee Profile → Position → Position ID

Update worker

NOTE - ONLY workers in a Hired state in ADP can be updated. Worker updates for IN-PROGRESS state are not supported

Using the Enboarder ADP Data connector, we can Update an existing Worker in real-time by configuring a webhook module and adding it in any sequence as shown below.

The following fields can be updated in your webhook:

Name
Birth Date
Gender
Legal Address
email
mobile

Webhook Detail:

URL - https://enboarder-adp/integration/updateworker
Authentication - Please select ADP from the list.
Method - PUT

Payload - Please add the payload sample to your webhook and make sure the keys and dynamic tokens are matching as per the mapping table.

{
  "name": {
    "firstName": "{{firstname}}",
    "lastName": "{{lastname}}"
  },
  "birthDate": "{{birthdate}}",
  "gender": "{{Gender}}",
  "legalAddress": {
    "lineOne": "{{address/line1}}",
    "lineTwo": "{{address/line2}}",
    "lineThree": "{{address/line3}}",
    "cityName": "{{address/city}}",
    "subdivisionCode": {
                    "name": "{State code} - {State name}",
                    "subdivisionType": "State"},
    "countryCode": "{{address/countrycode}}",
    "postalCode": "{{address/postalcode}}"
  },
  "email": "{{email}}",
  "mobile": "{{mobile}}"
}

Worker Data Sync

No action is required. The below data will automatically sync every 24 hours at 6 AM and update Enboarder if a Worker exists in the database.

The following fields will update automatically:

Name
Email
Mobile

TroubleShooting

You can now investigate mapping issues very easily by using the Integration Logs. The API responses are now available within the product UI. Please go to Setting -> Integration -> Audit logs for that account to view a complete payload. There may be multiple rows. One contains the complete response message and the rest will provide information regarding workflow processing.

Click on the row to see a complete payload or more details.