Troubleshooting LinkedIn Requisition Posting and Candidate Sync Errors

With a successfully connected LinkedIn Recruiter System Connect (RSC) or Apply Connect integration, ClearCompany requisitions and an applicant's LinkedIn information can be synced between LinkedIn and ClearCompany. If an applicant or requisition fails to sync between the systems for any reason, we will display an error message within the Sync Logs page in ClearCompany.

In this article:
Viewing the Sync Logs
Viewing Error Details
Common Requisition Sync Errors
Common Applicant Sync Errors
Support Contacts
FAQs

Viewing the Sync Logs 

To find the errors in the Sync Logs, users with both the Recruiter and User Admin permission can navigate to Tools > Setup > Recruiting Setup > LinkedIn Integration within ClearCompany. From the LinkedIn Integration page, select the Sync Logs tab. 

Viewing Error Details

The details of each sync error can be found by clicking the blue 'details' button located on the far right of the error message row. Additionally, you can click anywhere on the sync error row to open the related Candidate or Requisition which is experiencing the error.

Best practice is to check your sync log and address any errors on a regular basis.

Common Requisition Sync Errors

ERROR :: /description :: length of "" is out of range 1...2146483647

This error message indicates an issue with the length of the Job Description for a specific requisition. Specifically, LinkedIn requires that jobs have a description length of at least 100 characters in order to successfully sync to their site.

 How to Fix:

1. Edit the details of the requisition in question to extend the length of the job description.
2. Upon resaving the requisition, the sync to LinkedIn should automatically be retried. Check the Sync Logs to confirm if any other errors arose for this requisition.

Location cannot be empty if postalCode and countryCode are not provided...

This error message indicates an issue with the Posting Location data for the requisition. LinkedIn requires that a valid Zip Code and Country Code are listed for each job, even those that have Remote posting locations. This means that Offices with a Nationwide Address location in ClearCompany are not supported and if assigned to a requisition, will cause this error when syncing to LinkedIn.

Important Note

At this time, only organizations with the Apply Connect integration can post jobs with Remote locations. If your organization has the Recruiter System Connect (RSC) integration without Apply Connect, remotely located requisitions will fail to sync to LinkedIn.  To enable Apply Connect for your organization, follow this integration setup guide.

 How to Fix: 

Edit the Office & Requisition Posting Location details by following the steps below:

1. Navigate to Tools > Setup > Roles/Departments/Offices and select the Offices tab.
2. Locate the Office tied to the requisition that is failing to sync.
3. Click on the name of the Office and select 'Edit' to access the location details of the office. Update the office details to include an address location.
4. Edit the details of the Requisition in question by navigating to the Requisition > Details> Edit Details.
5. Ensure that an Office with an address is assigned to the requisition.
6. To mark the job as 'Remote' for posting, turn on the 'Work location is different from office location' toggle and select 'Remote/Anywhere'.

   

 

Job { ... } was dropped: true

This error message can be caused by a few different issues that we've outlined below.

1. Duplicate Posting Match

In this scenario, a match was found for the requisition from ClearCompany and an existing LinkedIn job posting, and therefore a duplicate post cannot be made. Specifically, LinkedIn reviews the Job Title, Location, and Apply URL of the requisition being synced and compares that against existing Job Posts listed for your company on LinkedIn.

 How to Fix:

1. First, within LinkedIn, remove any manually created Job Posts that have a matching requisition within ClearCompany.
2. Then, within ClearCompany, navigate to the requisition in question.
3. Resave the requisition details to retrigger the requisition sync to LinkedIn.

2. Flagged/Reported Post

In this scenario, a job may have been flagged by LinkedIn's post quality filters or a user may have reported the post, resulting in the posting being removed from LinkedIn's site and this sync error occurring. Please reach out to an available LinkedIn Support resource, listed below, for more information on why the job was removed and how to resolve the issue.

Job Processing due to server-side error, please retry

This error message indicates an issue processing the sync request.

 How to Fix:
Resave the requisition details to retrigger the requisition sync to LinkedIn.

Common Applicant Sync Errors

Missing or empty lastName field for atsCandidate value = {atsCreatedAt=[ID], firstName=Applicant, lastName=, addresses=[Address_Info]...

This error indicates an issue with the full name details of a particular applicant. Specifically, if we can't automatically populate a candidate's full name in ClearCompany, they will be assigned the name "Applicant" on their candidate profile. LinkedIn's Recruiter System Connect (RSC) requires a full name, consisting of a First and Last name, in order to successfully find a matching LinkedIn profile for the candidate.

 How to Fix:

1. Click on the Sync Log error record for this applicant to load their corresponding candidate profile in ClearCompany.
2. Review the details of the candidate, such as their Resume/Application, and update their name information by selecting Actions > Edit Candidate Info from the candidate profile.
3. Then, re-check the Sync Logs to confirm if any other errors arose for this candidate.

 

Support Contacts

LinkedIn:

For LinkedIn-specific questions, the following resources are available to you:

• If you have a LinkedIn Recruiter license, please reach out to your designated Account Manager.
• If you do not have a LinkedIn Recruiter license, you may reach out to [e-mail]. If your question is about the Apply Connect integration specifically, please indicate so in your email's Subject line.

ClearCompany:

If any of the error messages persist after following the fix recommendation, or you do not see your error message listed here, please contact ClearCompany Support through LiveChat, Phone: [phone] (option 1), or Email: [e-mail].

FAQs:

Q: How to re-trigger a  requisition's sync to LinkedIn?

A: Resave the details of a requisition or toggle On/Off the LinkedIn posting option in order to re-initiate the sync to sync to LinkedIn. To do so, follow the steps below:

Resaving the Requisition Details

1. Navigate to the requisition in question
2. Click into the Details page of the requisition
3. Click the 'Edit Details' button in the top-left of the Info page
4. Without editing the requisition, click the Save button at the bottom of the page