When an integration is enabled on Perk, you can download the integration’s Sync Log, which outlines the updates and errors that occurred during the sync.
In the Employee Updates tab, you can find information about any account creations, changes to information, or assignments made during the sync process.
Errors Tab
The Errors tab outlines any errors that caused the sync to fail for some people.
Remember that not all errors need to be resolved. For example, people who are hire rescinds may not have a starting date in your HR tool. They may cause the error message missing_start_date. No action is required in this situation, and no account will be created for this person in Perk.
Here is a list of some common errors and their solutions to ensure a Perk account is created successfully.
User flow error codes
Error Code
Solution
MISSING_START_DATE
Check if the person has a Start Date in their profile on your HR tool.
Add a start date to their profile on the HR tool and save.
Run a manual sync on Perk.
MISSING_EMAIL
Check if the person has a Work Email in their profile on your HR tool.
Add an email to their profile on your HR tool and save.
Run a manual sync on Perk.
MISSING_FIRST_NAME
Check if the person has a First Name in their profile on your HR tool.
Add the first name to their profile on your HR tool and save.
Run a manual sync on Perk.
MISSING_LAST_NAME
Check if the person has a Last Name in their profile on your HR tool.
Add the last name to their profile on your HR tool and save.
Run a manual sync on Perk.
DATE_OF_BIRTH_IS_MISSING_OR_INVALID
Check if the person has a Date of Birth in their profile on your HR tool.
Add or edit the date of birth in their profile on your HR tool with the correct format MM/DD/YYYY and save.
Run a manual sync on Perk.
PHONE_IS_MISSING_OR_INVALID
Check if the person has a Contact Number in their profile on your HR tool.
Add or edit the contact number in their profile on your HR tool with the correct format: +(area code) (phone number) and save.
The space between the area code and phone number is mandatory.
Run a manual sync on Perk.
SEX_IS_MISSING_OR_INVALID
Check if the person has a Gender in their profile on your HR tool.
Add or edit the gender in their profile on the HR tool and save. Currently, only the M or F options are available. We are working on adding more options.
Delete the duplicate person or change the email address.
Run a manual sync on Perk.
USERNAME_INVALID
The email contains invalid characters such as special characters, for example : - , !.
Check the User Name field in the person’s profile on your HR tool.
Remove any invalid characters.
Run a manual sync on Perk.
Approval flow errors
Error Code
Solutions
MANAGER_DOES_NOT_EXIST
Check the name of the direct line manager in the Supervisor field on the person’s profile on your HR tool.
If the direct line manager is still valid, there may be an error causing the manager’s account not to be created. Check the error log to identify this error and resolve it.
If the direct line manager is not valid, change the information in the Supervisor field to the correct line manager. Then, run a manual sync on Perk.
Make sure that the person with the Guest role is assigned to an approval process where approval requests for all in-policy and out-of-policy trips will be sent to an approver.
Find the relevant person and at the end of the row, click on the three dots.
Click Edit personal information.
Under Access and permissions, click Edit.
Change the role of the Guest to one of the other roles.
Run a manual sync on Perk.
If the person doesn't need to be an approver: Ensure that the person is not assigned as a direct line manager or found in the Supervisor field on your HR tool.