LinkedIn Integration Setup Troubleshooting Guide

In this article, we will explore commonly asked questions and concerns around the initial configuration of LinkedIn integrations (Recruiter System Connect and Apply Connect). If you have not set up any LinkedIn Integrations with your ClearCompany account, you can follow these setup guides to begin: Recruiter System Connect & Apply Connect.

In this article:
Setup Prerequisites
F.A.Q.
Troubleshooting Errors

Setup Prerequisites

1. The user completing the integration is:
   • A User Admin and Recruiter in ClearCompany
   • Has a full LinkedIn Recruiter Contract, not Recruiter Lite
   • An Admin on the Reruiter Contract

Frequently Asked Questions

Q: How do I check if I have a Recruiter vs Recruiter Lite contract?

Answer: When logged in to www.linkedin.com, review the top navigation bar of your LinkedIn homepage. Next to the Work button in the top-right corner, you will either see a Recruiter or Recruiter Lite button depending on your contract type.

Below is an example of a Recruiter contract homepage.

For more information, review this LinkedIn Help Center article. You can also use LinkedIn's Live Chat option (found at the bottom of their help center) to ask a LinkedIn Support Representative to confirm your Contract details.

Q: How to check if I am a LinkedIn Recruiter Admin?

Answer: When purchasing a LinkedIn Recruiter license, one or more seat holders will be designated as administrators on the contract. Only contract administrators can adjust contract settings or turn on additional LinkedIn integrations like Recruiter System Connect and Apply Connect. Users with the Recruiter Admin Role on LinkedIn are considered Contract Admins.

LinkedIn Role Descriptions:

If you're an Account Center Admin on LinkedIn, you can review the roles and permissions of each user on your Recruiter contract: 

1. Within LinkedIn Recruiter (https://www.linkedin.com/talent/home), click on your profile in the top-right corner. Select 'Manage users in Account Center' from the dropdown menu.

Note:

If you don't see the 'Manage users in Account Center' option, please connect with your team internally to locate your Account Center Admin who can complete these steps.

2. Navigate to the Users page of the Account Center and click on the name of the user to review.

3. On the user's profile, check if the user has the Recruiter Admin Role.

4. If the user does not have the Recruiter Admin Role but should, click the 'Manage License' button on the far right to select the Recruiter Admin Role.

Additional LinkedIn Help Materials:
Available Roles in Recruiter
Available License and Permission Types in LI Recruiter
Assign Admin Permissions in Recruiter

Troubleshooting Errors During Integration Setup

This section details common issues that you may encounter when trying to load the LinkedIn Integration configuration plugin on the LinkedIn Integrations Setup page.

The plugin fails to display at all. You may see a thin bar where an attempt to display the plugin was made.

Recommended Solution

This typically indicates a LinkedIn permission and/or login issue. Please check the following and then re-login to ClearCompany.

1. You have an Active seat on your organization's LinkedIn Recruiter contract.
2. You are an Admin of your organization's LinkedIn Recruiter contract.
3. You are logged in to linkedin.com using the same email address as noted on your contract seat.
4. You are logged in to your LinkedIn account in a tab within the same browser window as ClearCompany.

The plugin displays with the message: “There seems to be a problem. You do not have enough permission to access this page.”

Recommended Solution

This error message is usually seen when the LinkedIn account you're signed into does not have the appropriate level of permissions required to set up the integration. Ensure the following are true:

• You are logged in to your LinkedIn Recruiter account in another tab within the same browser window as ClearCompany.
• Your LinkedIn Recruiter seat is Active and has been granted Admin privileges your organization's contact.

After making any of the above corrections, please log out and back into ClearCompany to try again.

On the LinkedIn Integration page within ClearCompany, you see a message that says,"Domain validation failed for the API key. Please contact your ATS for further assistance.”

Recommended Solution

This error message indicates a configuration error. Contact the ClearCompany Support team for further assistance.

The green, 'successful sync' banner has not appeared after a few hours, up to a day depending on the size of your organization.

Recommended Solution

Toggle off/on the ClearCompany ATS Integration Settings in LinkedIn. Steps on how to complete this are listed below.

1. Log into your LinkedIn Recruiter account used to begin the integration setup process.
2. Access the ATS Integration page in your LinkedIn Recruiter account (steps a, b, and c in the image below)
3. Within the ClearCompany section, toggle Off the Company level access and Save the changes. (Steps d and e in the image above). Then, edit the settings and toggle back On the Company level access. Save changes.
4. Save your changes. Wait for the integration sync to take place and check the LinkedIn Integration page in ClearCompany for the green sync banner to indicate a successful integration configuration.

Additional Resources

Enable LinkedIn Apply Connect with ClearCompany

Enable LinkedIn Recruiter System Connect (RSC) with ClearCompany