Welcome to the Bucketlist Rewards x Dayforce integration guide! This integration enables you to seamlessly sync employee data from Dayforce into Bucketlist to power automated recognition moments, milestone awards, and real-time engagement insights.
Article Contents
- Step-by-Step integration Setup Instructions
- Go-Live checklist
- Field mapping outline
- Troubleshooting
Step-by-Step Integration Setup Instructions
Step 1: Create a role in Dayforce to ensure the API’s service account that we will create in follow up steps have only the necessary permissions to read what is needed by the integration.
- Login in Dayforce with a user that can edit and create roles
- Navigate to the ‘System Admin > Roles’ section
- Click on the ‘Add’ button and fill the mandatory fields and the description field (optional)
- In the Name field, enter the role’s name, for example “Bucketlist Rewards API Access”
- In the Description, you can enter something descriptive for the service account.
- In Password Policy, choose the password policy or create a password policy per your password standards.
- In Reference Code, enter a reference code. For example: role-bucketlist-api
- Click on the Save button
-
Still on the role selected, open the “Authorization” tab
-
Check the “Can Read” checkbox for all the following rows:
-
Employee Contact Information
-
Employee Contact Information – Business
-
Employee Key Information
-
Employee Number
-
Employee Personal Information
-
Employee Personal Information XrefCode
-
Employee Profile – Security Settings – Roles
-
Employee Status Information
-
Employee Work Assignment
-
Employee Work Assignment – Secondary Records
-
Forms – Employee Status Information
-
Pay Information
-
User Information
-
-
Click on the “Web Services Field-Level Access” tab
-
Expand “RESTful Services > Human Resources > Employee”
-
Check the following checkboxes under Address:
-
Addresses > ContactInformationType ContactInformationTypeGroup > XRefCode
- Addresses > ContactInformationType > XRefCode
-
-
Check “Addresses > Country > XRefCode” under Addresses
-
Check “Birthdate”
-
Note: This is optional and needed only if we want to configure Birthday Awards. The date will be sent to Bucketlist Rewards in the format year-month – the “day” is not sent to Bucketlist Rewards.
-
-
Check the following checkboxes under Contacts
-
Contacts > ContactInformationType > ContactInformationTypeGroup > XRefCode
-
Contacts > ContactInformationType > XRefCode
-
Contacts > EffectiveEnd
-
Contacts > EffectiveStart
-
Contacts > ElectronicAddress
-
-
Check the “ManagerXRefCode” checkboxe under EmployeeManagers
-
Check “EmployeeNumber”:
-
Check the following checkboxes under “EmploymentStatuses”
-
EmploymentStatus > LongName
-
EmploymentStatus > ShortName
-
EmploymentStatus > XRefCode
-
-
Check “First Name”
-
Check “Last Name”
-
Check the following checkboxes under “Roles”
- IsDefault
-
Role > ShortName
-
Check StartDate
-
Check the following checkboxes under “WorkAssignments”
-
Location > LegalEntity > Country
-
Location > LegalEntity > ShortName
-
-
Check the following checkboxes under “WorkAssignments”
-
Position > Department > ShortName
-
Position > ShortName
-
-
Check “XRefCode”
-
-
Click on the “Save” button
Step 2: Service Account Creation- Once the role is added and configured, you can create the “employee” account that will serve as the service account that BucketlistRewards will need to access Dayforce’s API.
-
In the left navigation menu, click on System Admin > User
-
Click on the “New” button
-
In the bottom form, fill up these fields:
-
User Name: Give a name to the user, like “bucketlist_integration“ or something similar. This will need to be provided to your Bucketlist Rewards contact.
-
Culture: This isn’t relevant to Bucketlist Rewards integration, but this is a mandatory field, so please choose a culture like English (US) etc
-
Click on the “arrow icon” besides the “password” field to generate a new password
-
Click on the “eye icon” to view the password – This will need to be provided to your Bucketlist Rewards contact.
-
Click on the “Add User Role” button
-
Select the role that was created in the previous section
-
Leave the default options for “is Default” checked
-
Set the effective start date of the role to be in the past, for example “1/1/1950”
-
-
You will need to add a location.
-
Click on the “Location Access” tab
-
Click on the “Add Location” button
-
Click on the in the new row, and select the highest level of the organization and click on “OK”
-
Set the location’s effective start to be in the past and the same as the effective start on the role. (e.g. “1950-01-01”)
-
-
Click on the Save button to save the new user
-
Step 4: Share Service Account Credentials
You need to share the username and password with your Bucketlist Rewards contact, in a secure manner using ShareFile. They will setup the integration for you on Bucketlist Rewards’ side.
Once configured the integration runs a daily sync between Dayforce and Bucketlist Rewards. This means changes will not appear immediately — it can take up to 24 hours for any user-related changes to be reflected.
Field Mapping
Bucketlist Field | Dayforce Field |
First Name | Personal > Contact Information > First name |
Last Name | Personal > Contact Information > Last name |
Business Email | |
EmployeeID | XRefCode |
Hire Date (Optional) | Employment > Employment Settings > Key Information > First Date Worked |
Birthdate (Optional) | Personal > Confidential Information > Birth Date |
Groups (Optional) |
|
Country | Personal > Contact Information > Country field of the primary Address |
ManagerID | Go to the employee’s manager > In Work > Management Assignment add the employee |
Troubleshooting
⚠️ Issue: User Data Not Syncing
Description: You may notice one or more of the following problems:
- New users added in Dayforce are not appearing in Bucketlist
- Users removed from Dayforce are still showing as active
- Updates to user information (name, email, department, etc.) are not appearing
Why This Happens: The integration runs a daily sync between Dayforce and Bucketlist Rewards. This means changes will not appear immediately — it can take up to 24 hours for any user-related changes to be reflected.
Steps to Remedy
- Make the necessary user changes in Dayforce (add, remove, or update user info).
- Wait 24 hours for the daily sync to run.
- After 24 hours, refresh your user list in Bucketlist Rewards to check if the changes have appeared.
- If the changes are still not showing, contact your Customer Success Manager or email support@bucketlistrewards.com.