Skip to main content

​
Overview

To authenticate with Dayforce, you will need:
  1. Company ID - Your unique Dayforce company identifier.
  2. Username - Your Dayforce account username.
  3. Password - Your Dayforce account password.
  4. Client host (optional) - Your Dayforce instance API hostname, leave empty for production.
  5. Identity host (optional) - Your Dayforce Identity hostname, leave empty for production.
This guide will walk you through configuring your Dayforce user and obtaining your Company ID.

​
Prerequisites:

  • You must have a Dayforce account with administrative access.
Important Note: Having a live integration will hide the option to edit member details manually. This is because the integration automatically becomes a Provision Master (main expected source of employee data) and other member updating methods become unavailable to prevent conflicting data sources. If you need to do a manual edit, please disable the integration by going to Integrations > Tools > Edit > turn the toggle OFF. Once you finish your edits, turn it back ON from the same toggle.

​
Instructions:

​
Step 1: Finding your Company ID

  1. Once logged in, look at the URL in your browser’s address bar.
  2. For example if the url is https://test.dayforcehcm.com/acme, the Company ID would be acme.

​
Step 2: Configure your Dayforce user

  1. Log in to your Dayforce account.
  2. Navigate to System Admin > User and find your user account.
  3. Important: Click on your user and select the “Is Default” checkbox for the role you will be configuring for this integration. This step is crucial for the integration to work properly.
  4. From the hamburger menu in the top left, click System Admin > Roles.
  1. Navigate to Features and ensure HCM Anywhere and Web Services are checked, with Read Data enabled at a minimum.
  1. Navigate to Web Services Field-Level Access.
  1. Depending on your use case, click on the words (not the empty check box) and click Select All.
  2. Navigate to the Human Resources section of RESTful Services.
  3. Expand Employee, and scroll to the very last one to ensure XRefCode is enabled.
  4. Navigate to System Admin > User. Please note, the user authenticating will need “Can See Self” enabled.
  1. Expand the User by clicking the small down arrow.
  2. Click on Location Access, then + Add Location, and add the Company Level Location.
  1. Optional: If you need support for writes functionality (i.e. POST /Time-Off), navigate to System Admin > Roles > Features and ensure under HCM Anywhere and Web Services, Patch/Post Employee Time Off is enabled.

​
Step 3: Identifying your Identity host

Identity host is used for the token endpoint. The token URL format is: https://{identity_host}/connect/token.
  • Production: Leave Identity hostname empty. Nango uses dfid.dayforcehcm.com (e.g. https://dfid.dayforcehcm.com/connect/token).
  • Test: Enter your identity host, e.g. dfidtst.np.dayforcehcm.com (e.g. https://dfidtst.np.dayforcehcm.com/connect/token).
These details are typically in your Dayforce welcome email or provided by your HR/IT administrator.

​
Step 4: Identifying your Client host

Client host is your Dayforce instance URL hostname, the host used for API requests (e.g. https://{client_host}/api).
  • Production: Leave API hostname empty. Nango uses www.dayforcehcm.com.
  • Test/sample: Enter your instance host, e.g. usconfigr58.dayforcehcm.com for a sample environment or test.dayforcehcm.com for test environment.
These details are typically in your Dayforce welcome email or provided by your HR/IT administrator.

​
Step 5: Enter credentials in the Connect UI

Once you have your Company ID, Username, and Password (and optional Client host and Identity host for non-production):
  1. Open the form where you need to authenticate with Dayforce.
  2. Enter your Company ID, Username, and Password in the designated fields.
  3. Submit the form, and you should be successfully authenticated.
You are now connected to Dayforce.