Overview
To authenticate with Dayforce, you will need:
- Company ID - Your unique Dayforce company identifier.
- Username - Your Dayforce account username.
- Password - Your Dayforce account password.
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
- Once logged in, look at the URL in your browser’s address bar.
- For example if the url is
https://test.dayforcehcm.com/acme, the Company ID would beacme.
Step 2: Configure your Dayforce user
- Log in to your Dayforce account.
- Navigate to System Admin > User and find your user account.
- 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.
- From the hamburger menu in the top left, click System Admin > Roles.
- Navigate to Features and ensure HCM Anywhere and Web Services are checked, with Read Data enabled at a minimum.
- Navigate to Web Services Field-Level Access.
- Depending on your use case, click on the words (not the empty check box) and click Select All.
- Navigate to the Human Resources section of RESTful Services.
- Expand Employee, and scroll to the very last one to ensure XRefCode is enabled.
- Navigate to System Admin > User. Please note, the user authenticating will need “Can See Self” enabled.
- Expand the User by clicking the small down arrow.
- Click on Location Access, then + Add Location, and add the Company Level Location.
- 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: Configure your Dayforce user
- Whitelist the following IP addresses
- 52.34.139.153,
- 54.69.127.183,
- 44.247.133.183,
- 52.26.211.56
- For the user that was created, enable the following permissions
1. From the Features tab, expand HCM Anywhere > Web Services and enable Read Data.
2. Go to the Web Services Field-Level Access tab.
3. Expand RESTful Services > Human Resources.
4. Expand Employee and enable it. You must also include XRefCode.
5. Expand and enable:
- EmployeeManager
- EmployeeRole
- EmployeeEmploymentType
- PersonContact
- EmployeeWorkAssignment
7. Go to the Authorizations tab and enable Can Read for:
- Employee Contact Information
- Employee Contact Information – Personal and/or Business
- Employee Status Information
- Employee Profile – Security Settings – Roles
- Employee Profile – Security Settings – Locations
- Employee Work Assignment – Primary/Secondary Records
Step 4: Connect Your DayForce Account
Once you have your Company ID, Username, andPassword:
- Go back to Allvoices integrations page, and open the dayforce form where you will authenticate with Allvoices.
- Enter your Company ID, Username, and Password in the designated fields.
- Submit the form, and you should be successfully authenticated.
You are now connected to Dayforce.
Fields that will get pulled
Field |
Value Type |
| id | string |
| firstName | string - Required |
| lastName | string |
| string - Required | |
| displayName | string |
| employeeNumber | string (optional) |
| title | string |
| department.id | string |
| department.name | string |
| employmentType | 'FULL_TIME' | 'PART_TIME' | 'CONTRACTOR' | 'INTERN' | 'TEMPORARY' | 'OTHER' |
| employmentStatus | 'ACTIVE' | 'TERMINATED' | 'ON_LEAVE' | 'SUSPENDED' | 'PENDING' |
| startDate | string (ISO date) |
| terminationDate | string (ISO date, optional) |
| manager.id | string (optional) |
| manager.firstName | string (optional) |
| manager.lastName | string (optional) |
| manager.email | string (optional) |
| workLocation.name | string |
| workLocation.type | 'OFFICE' | 'REMOTE' | 'HYBRID' |
| workLocation.primaryAddress.street | string (optional) |
| workLocation.primaryAddress.city | string (optional) |
| workLocation.primaryAddress.state | string (optional) |
| workLocation.primaryAddress.country | string (optional) |
| workLocation.primaryAddress.postalCode | string (optional) |
| workLocation.primaryAddress.type | 'WORK' | 'HOME' (optional) |
| addresses[].street | string |
| addresses[].city | string |
| addresses[].state | string |
| addresses[].country | string |
| addresses[].postalCode | string |
| addresses[].type | 'HOME' | 'WORK' |
| phones[].type | 'WORK' | 'HOME' | 'MOBILE' |
| phones[].number | string |
| emails[].type | 'WORK' | 'PERSONAL' |
| emails[].address | string |
| createdAt | string |
| updatedAt | string |
DayForce Specific fields
DayForceSpecific Field
|
| dayforceEmployeeNumber |
| dayforceMiddleName |
| dayforcePreferredName |