When an integration is enabled on TravelPerk, you can download the integration's Sync Log, which outlines the updates and errors faced during the sync.
Download the Sync Log
- Go to Account Settings
- Select Integrations
- Find the integration and click Manage
- Click Download XLS Log

Information stored in the Integration Sync Log
Employees Update tab
In the Employee Updates tab, you can find information about any user creations, user information changes, or user assignments made during the sync process.

Errors Tab
The errors tab outlines any error that caused the sync to fail for some users. Remember that not all errors need to be resolved.
Here is a scenario where no further action is required:
Hire Rescinds |
Users who are hire rescinds may not have a starting date in your HR tool. They may face an error code such as 'missing_start_date.'
No action will be needed for this User. You can be assured that no account will be created for this user in TravelPerk.
|
To fix the errors and make sure the user has a TravelPerk account created, follow the steps below depending on the error code:
Error Code |
Step-by-Step Resolution |
USER FLOW ERROR CODES |
MISSING_START_DATE |
- Check if the user has a Start Date in their profile on the HR tool
- Add in a start date to their profile on the HR tool and save
- Run a manual sync on TravelPerk
|
MISSING_EMAIL |
- Check if the user has a Work Email in their profile on the HR tool
- Add an email to their profile on the HR tool and save
- Run a manual sync on TravelPerk
|
MISSING_FIRST_NAME |
- Check if the user has a First Name in their profile on the HR tool
- Add the first name to their profile on the HR tool and save
- Run a manual sync on TravelPerk
|
MISSING_LAST_NAME |
- Check if the user has a Last Name in their profile on the HR tool
- Add the last name to their profile on the HR tool and save
- Run a manual sync on TravelPerk
|
DATE_OF_BIRTH_IS_MISSING_OR_INVALID |
- Check if the user has a Date of Birth in their profile on the HR tool
- Add or edit the date of birth in their profile on the HR tool with the correct format MM/DD/YYYY and save
- Run a manual sync on TravelPerk
|
PHONE_IS_MISSING_OR_INVALID |
- Check if the user has a Contact Number in their profile on the HR tool
- Add or edit the contact number in their profile on the HR tool with the correct format:
+(area code) (phone number) and save.
Note: The space between the area code and phone number is mandatory.
- Run a manual sync on TravelPerk
|
SEX_IS_MISSING_OR_INVALID |
- Check if the user has a Gender in their profile on the HR tool
- Add or edit the gender in their profile on the HR tool and save.
Note: Currently, we only have the M or F options. We are working on adding more options.
- Run a manual sync on TravelPerk
|
USER_EXISTS_IN_INVITED_STATE |
- On TravelPerk, go to the People page
- Select the Invited tab
- Find the relevant user and click on the 3 dots
- Click Revoke invitation
- Run a manual sync on TravelPerk
|
USER_HAS_UPCOMING_TRIPS |
The user cannot be offboarded due to upcoming trips.
When the trips are complete, run a manual sync on TravelPerk.
|
USER_DUPLICATE_EMAIL |
- On TravelPerk, go to the People page
- Search using the email address
- Delete the duplicate user or change the email address
- Run a manual sync on TravelPerk
|
USERNAME_INVALID |
The email contains invalid characters such as special characters, for example : - , !.
- Check the User Name field in the user's profile on the HR tool
- Remove any invalid characters
- Run a manual sync on TravelPerk
|
APPROVAL FLOW ERROR CODES |
MANAGER_DOES_NOT_EXIST |
Check the name of the direct line manager in the Supervisor field on the user's profile on the HR tool.
- If the direct line manager is still valid, there may be an error causing the manager's user 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 TravelPerk.
|
GUEST_MEMBERS_REQUIRE_APPROVAL_FOR_ALL_TRIPS |
- On TravelPerk, go to Account settings
- Under Travel Management, select Approval processes
- Make sure that the user 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
|
GUEST_USERS_CANNOT_BE_APPROVERS |
If the user needs to be an approver:
- On TravelPerk, go to the People page
- Find the relevant user and click on the 3 dots
- Click Edit Personal
- Change the role of the Guest to one of the other roles
- Run a manual sync on TravelPerk
If the User does not need to be an approver: Ensure that the user is not indicated as a direct line manager or found in the Supervisor field on the HR tool.
|