Skip to main content

Set up LinkedIn Recruiter System Connect

  • SmartRecruit


Follow these instructions to integrate LinkedIn Recruiter System Connect with your SmartRecruiters account.


To set up the integration, companies will need a LinkedIn Recruiter contract and a SmartRecruiters account. LinkedIn Recruiter Lite is not supported for this integration.

Setup for SmartRecruiters' LinkedIn Recruiter integration is a three-step process:

  1. Request the integration by selecting a LinkedIn Recruiter Contract.
  2. Enable the integration in LinkedIn.
  3. Connect each SmartRecruiters user with their seat in LinkedIn Recruiter.

Once this is complete, LinkedIn will initiate a one-time sync of historical data from SmartRecruiters.

To complete all steps of the integration setup, you need to be both an Admin of SmartRecruiters and of your company's LinkedIn Recruiter contracts.

Customers who haven't already connected their LinkedIn Recruiter and SmartRecruiters accounts can simply go through the process to set up the integration.

Request integration

  1. Log in to SmartRecruiters as an Administrator. 
  2. Access the LinkedIn Recruiter System Connect page by going to your Admin/Settings page and selecting Apps & Integration link under the Administration section.
  3. Navigate to the bottom of the list and click on the LinkedIn Recruiters System Connect integration. Screen Shot 2020-04-08 at 10.52.24 AM.png
  4. As part of the integration process, SmartRecruiters will share data (list here) about your current and future candidates, jobs, and applications. Check the box next to "I recognize[...]" to acknowledge your agreement and proceed.
  5. Click + Add Contract
  6. In the popup, click Sign in.SignIntoLIR.png
  7. Enter your LinkedIn Recruiter credentials to login. 
  8. From your list of LinkedIn Recruiter contracts, select which contract to connect to SmartRecruiters and click Continue. You'll be able to add more later. (If you have only one contract, you'll automatically skip to the next step once you log into LinkedIn Recruiter.)ChooseContract.png
  9. In the Recruiter System Connect section, click Request to set up the integration's company-level access.  ConnectContract.png
  10. Wait a moment while SmartRecruiters completes this step with LinkedIn. When it's done, you'll see this screen:LRSC_5.png
  11. Click Finish. 

  12. Find the contract in the list, and click Enable in LinkedIn. You'll be taken to your LinkedIn Recruiter account.EnableInLinkedIn.png

Enable in LinkedIn Recruiter

  1. Once you're inside your LinkedIn Recruiter account, open the More menu at the top of the screen, and click Admin Settings.AdminSettings_LIR.png
  2. Click the ATS tab. LRSC_8.png
  3. Click the toggle for Company Level Access to activate it.CompanyLevelActivated.png
  4. Click the toggle for Contract Level access to activate it.ContractsLevelAccess.png
  5. Once both are activated, you'll see that the overall integration is activated in LinkedIn Recruiter.
  6. Go back into SmartRecruiters and reload the page to verify the integration status:LRSC_10.png

At this point, a one time sync of historical jobs, candidates, and applications will be initiated in the background. 

Historical data sync

When you setup the integration for the first time, the one time sync of historical data will take anywhere between 2-24 hours. Duration depends on the size of your company's dataset.

For jobs, we'll export:

  • Job title
  • Job Ad description
  • Location
  • Job Ad URL
  • Job Publish date

For candidates, we'll export:

  • First and Last name
  • Email
  • SmartRecruiters Profile URL
  • Creation date
  • Last updated date

For applications, we'll export:

  • First and Last name
  • Email
  • Job applied to
  • Application status
  • Source
  • Creation date
  • Last updated date

 To check that the data sync has completed follow these steps: 

  1. Go to your LinkedIn Recruiter account.
  2. Open a candidate profile 
  3. Go to "Export to..." functionality and search for a specific job in the dropdown picker. 
  4. Type a job name that you know exists. You should be able to see the job in search results when you type that job name into the export feature. 

Going forward, updates to the candidate status and historical job, candidate and application data will be synchronized and continuously updated across SmartRecruiters and LinkedIn Recruiter.

Add another contract

If you have multiple contracts, just click + Add Contract again and follow the same steps to enable another contract. 

If you've already added a contract, make sure to log out of LinkedIn Recruiter before attempting to add another contract. Otherwise, LinkedIn won't allow you to choose a contract.

If not, it's time to connect your users.

Connect users 

Once you've connected your LinkedIn Recruiter contract to SmartRecruiters, the final step to complete setup is to map your LinkedIn Recruiter seat holders to SmartRecruiters users so that SmartRecruiters can import and sync over candidates, historical InMails and Prospect Notes from LinkedIn Recruiter. Without this user account mapping, SmartRecruiters cannot import candidates, InMails, or notes.

  1. Find the contract in the list, and click Connect Users.
  2. SmartRecruiters will automatically pull in your LIR seatholders. LRSC_11.png
  3. To connect a LinkedIn user account, start typing their name in the SmartRecruiters User field:LRSC_12.png
  4. Repeat for each user who should be able to use the integration.
  5. When finished, click Close.

Once the integration is completed, InMails and Prospect Notes created by your seat holders will continuously sync into SmartRecruiters every 30 minutes.

LinkedIn seatholders must set their LinkedIn profile's visibility to Public in their profile settings, and activate Profile Visibility off LinkedIn in their Data Sharing settings.

Disabling the integration

Currently, customers must reach out to the LinkedIn support team to disable a connected LinkedIn Recruiter contract. Please contact with your LinkedIn Recruiter contract ID and reach out to the SmartRecruiters support team using our in-product support form.