Contact Support

Integration with ADP Workforce Now

Updated

If you wish to set up an integration to import all employee data from ADP Workforce Now to the Awardco platform, please refer to the instructions below to get started.

Note: To finalize this integration, you must be an administrator for both Awardco and ADP.

Warning: If you already have employee data in your Awardco platform, please confirm that the Employee IDs you will be using in your new data feed are consistent with your current user data. Failure to do so can result in the duplication of users, recognition errors, and loss of data integrity.

  1. Setup
  2. How to Update Your ADP Subscription
  3. FAQ

Setup

Begin Setup

While the integration is available in the ADP Marketplace, we suggest starting the setup in the Awardco Integrations Library.

  1. Click the “Admin” button at the bottom of the left navigation menu.
  2. From the left navigation menu, select "Platform," "Integrations," and "Integrations Library."
  3. Click on “ADP Workforce Now”.
  4. Click “Begin Setup”.

 

Purchase and Connect the Integration

 

 

  1. Copy the temporary company key provided.
  2. Go to ADP using the link provided in the modal and click “Buy Now”.
  3. Ensure that you are purchasing the appropriate pricing tier of the integration for your organization. If you anticipate exceeding the user limit specified in your chosen tier, select a package that aligns with the size of your workforce for that year.
  4. You’ll see an alert that says “There is missing or incorrect information”. Click “Edit”, paste the temporary company key in the ‘Awardco Temporary Company Key’ field.
  5. Click “Save”, and then press “Next”.
  6. Agree to ADP’s terms of service and click ‘Complete Purchase’.
  7. Return to the setup process in Awardco and press 'Continue' to proceed with the setup wizard.

 

ADP Integration Subscription Tiers.png

 


 



 

 

Complete Client Authorization

  1. The ADP administrator should click the client authorization link.
  2. Agree to the terms and conditions in ADP.
  3. Return to Awardco and click “Continue”.

 

Configure Mapping Settings

On this page, you will map fields from ADP to corresponding fields in Awardco. You can also create custom metadata fields using ADP data (refer to our dedicated Support article for detailed instructions).

Some fields, such as "Employee ID" and "Supervisor ID," are preset to ensure the organizational hierarchy imports correctly.

Important Notes:

  • Be aware that not all fields are guaranteed to have values. After the import, run a User report to verify that the correct information is being populated.
  • The ADP import will include all employees who have an “Active” or “Leave” status for their primary position in ADP.
  • "Employee ID" and "Supervisor ID" are automatically mapped to the ADP "Position Id" for the employee and their supervisor, respectively. This ensures the accurate import of the organizational hierarchy.
  • "Phone Number" is also preset. The system will first check for a personal mobile number, and then a business mobile number. This field is only utilized if your company is also using Awardco’s SMS feature.
  • Several other fields are preset for your convenience.
  • "First Name" and "Last Name" are required fields. It is recommended that you use “Legal First Name” and “Legal Last Name” as ADP guarantees this information for every employee.
  • "Hire date" has several potential values:
    • /workers/workAssignments/hireDate is the recommended option.
    • Fields guaranteed to have data for all employees:
      • /workers/workAssignments/hireDate
      • /workers/workerDates/originalHireDate
    • Fields not guaranteed to have data for all employees:
      • /workers/workAssignments/seniorityDate
      • /workers/workerDates/rehireDate
  • The "#" symbol is unnecessary and not supported when adding metadata fields in the mapping settings.
  • When finished configuring the mappings, ensure you click “Save and Connect”.

 

Configure Connection Settings

  1. Click the “Connection Settings” tab within Awardco’s ADP Workforce Now integration setup page.
  2. Select the desired frequency for your user data synchronization from ADP to Awardco (daily, weekly, or monthly).
  3. Configure "Advanced Settings" as needed. Awardco representatives can provide assistance with these configurations.

 

Begin Using Integration

You are now ready to use the integration! Click “Connect” on the ADP Connection Settings page in Awardco. The integration will run automatically based on the frequency you selected.

 

How to Update your ADP Subscription

  1. Click the “Admin” button at the bottom of the left navigation menu.
  2. From the left navigation menu, select "Platform," "Integrations," and "Integrations Library."
  3. Click on “ADP Workforce Now”.
  4. Click on the “Connection Settings” tab and open “Advanced Settings”.
    • image.png
  5. Click “Update Subscription”.
  6. Copy the Awardco Temporary Company Key provided.
    • image.png
  7. Click the “Go to ADP” link.
  8. Log in to ADP, then on the marketplace page, click “Manage App”.
    • image.png
  9. Go to the “Update Subscription” tab.
  10. Select the desired subscription tier.
    • image.png
  11. Click “Continue”.
  12. Paste in the Awardco Temporary Company Key, then click “Check” to confirm.
    • image.png
  13. Review the updated payment and order details.
  14. Agree to ADP Marketplace terms and click “Place Order”.
image.png

 

Your subscription tier should now be updated.

 

FAQ

  • Q: Which clients are eligible to use this integration?
    • A: Awardco for ADP Workforce Now is currently available for US-based clients only. You must be using ADP Workforce Now and have access to the ADP Marketplace.
  • Q: Which ADP platforms does this integration work with?
    • A: This integration is designed for ADP Workforce Now, but it also works for clients on ADP TotalSource. For clients who use other ADP platforms (such as Vantage HCM or Enterprise HR), we recommend performing user file transfers via API or SFTP.
  • Q: I’m getting an error that the “Request Header is too long”. How do I fix this?
    • A: Try going through the installation process using an incognito/private browser window. If the problem persists, please contact ADP for assistance.
  • Q: Which user fields does this integration support?
    • A: This integration supports all of our standard user fields and also allows for the creation of metadata fields.
  • Q: Does this integration support Metadata Filters for companies who want to feed data from multiple HRIS platforms into Awardco?
    • A: No, the ADP integration does not currently support metadata filtering. The current workaround is to enter the Employee IDs of the non-ADP users in the “Do Not Archive” setting of the ADP integration (which requires manual input). The alternative is to perform traditional SFTP imports with both ADP and other employee database(s) and utilize our Metadata Filtering functionality.
  • Q: How often are data imports run?
    • A: Our daily import runs at 10:30 am UTC every day. For a weekly frequency, it runs at 10:30 am UTC on Mondays.
  • Q: I'm getting a blank user file when I run an import through the integration. How do I resolve this?
    • A: The integration filters out users who don’t have an active status in ADP. You’ll need to enable the ‘Status’ permission in your custom Marketplace Awardco Profile in ADP so that the integration knows who is active and who is not. If the permission is not enabled, no employees will register as active and no user data will be sent.

 



 

 

If you have any questions, please contact Awardco Admin Support.

Related to