Sometimes when you export candidates to your ATS, Hiretual might report errors indicating that the sync process has failed on the particular candidate. You can check the status of each sync on the Recent Pushed to ATS page and use the drop-down menu above the list to filter the failed syncs.
When you face these issues, don't panic! The failure of the sync could be triggered by various reasons. You can check out the list below and see what you can do to amend the issues case by case.
Fail - Unknown Reason
Fail - Found Duplicate
When Hiretual reports Found Duplicate, you have exported duplicated profiles to your ATS. While Hiretual is able to merge profiles that are highly identical, there are some profiles with similar information that you need to check manually before syncing.
For ATS with the Merge and Deduplicate feature*, you can go to the Recent Pushed to ATS page and click on the Merge & Sync link at the end of the row to manage the duplicate profiles.
Fail - Missing Data
The Missing data error suggests that the sync failed because some of the required fields are left blank on the candidate's profile. For ATS with the Missing Data Detection feature**, you can use the Edit & Sync link on the Recent Pushed to ATS page to add the information manually and then try to re-sync the candidate.
Fail - Token Expired
The Token Expired code shows that your API Credentials have expired. You may generate a new API key and re-integrate your ATS with Hiretual. If you are not the Hiretual admin for your team, you will need to connect with this person to have them help reintegrate Hiretual with your ATS.
Fail - Access Denied
The Access Denied notice suggests a permission issue. To amend this, please check and make sure that you have been granted the right permissions based on the ATS integration tutorial. You can locate the integration tutorials on the details page of the ATS under the Apps tab on the upper right corner of your screen.
You may also want to contact your Team Hiretual Admin or work with your ATS point of contact to make sure that you have the right permissions granted to the API keys.
Fail - 404 Not Found
The 404 Not Found sign indicates an error on Hiretual's end. Please reach out to us or contact your Customer Success Manager directly and our technical team will investigate the problem further from our end.
Fail - Too many requests
When you see the notification of too many requests, it shows that you and/or your team has hit the API rate limit for the integration. You can wait for 24 hours to reset the API limit. If this is a frequent error, you may want to discuss it with your Team Admin or reach out to your ATS point of contact to increase the rate limit for your API key.
Fail - ATS Server Error
Errors of this kind are also service errors from the ATS side (Server Error: > 500). When this occurs, try to export the candidate again. If the issue persists, please reach out to us or contact your Customer Success Manager directly and our technical team will help investigate further.
Fail - Data Format Error
The Data Format Error often suggests inappropriate field mapping between the Hiretual profile fields and your ATS profile fields. It may occur when you change the default mapping set. When you see this code, your Hiretual Admin can try to reset the data mapping under the respective ATS settings.
You are able to find the mapping options under the Settings tab of the details page of the ATS under the Apps tab.
*The list of ATS with the Merge and Deduplication feature:
Bullhorn, Greenhouse (Harvest API), iCIMs, JobAdder, JobDiva, Lever, PCRecruiter, Workday
**The list of ATS with the Missing Data Detection feature:
Beamery Frontier, Breezy, CATS, Copper, Crelate, Greenhouse (Harvest API), JazzHR, JobAdder, Jobdiva, Jobvite, Lever, PCRecruiter, Recruitee, Salesforce, SAP SuccessFactors, SmartRecruiters, Taleo (Business), Workable, Workday, Zoho