The Middleware Platform

The Middleware Platform represents a common set of APIs used to sync jobs, job applications, and talent profiles (such as candidates) between your ATS and LinkedIn on behalf of customers. Integrating with Middleware is essential for the Recruiter System Connect integration and powers a number of features.

Getting Started

  • All Middleware Platform operations are done on behalf of a customer. See Configure Customer Middleware Integrations for details on enabling and configuring customers to integrate with your ATS.
  • If you're developing a Recruiter System Connect integration, check out the guide for important prerequisites before proceeding.

Sync Jobs

Important

Required for: Recruiter System Connect

What You'll Do

  • When enabling a customer, use the Middleware Platform to send all historical jobs in bulk as a one-time process. Closed jobs must be included.
  • As jobs are created and updated by the customer, use the Middleware Platform to sync these new and udpated jobs.

See Sync Jobs for technical details.

Testing

  • Open jobs are available when exporting a candidate in LinkedIn Recruiter

Sync Candidates

Important

Required for: Recruiter System Connect

What You'll Do

  • When enabling a customer, use the Middleware Platform to send all historical candidates in bulk as a one-time process. Then, retrieve and store the LinkedIn ID for each candidate.
  • As candidates are created, updated, and deleted by the customer, use the Middleware Platform to sync these new and updated candidates. Then, retrieve and store the LinkedIn ID for each candidate.
  • As candidates apply to jobs, link candidates with job applications

The Middleware Platform will automatically link the candidates you send with Recruiter profiles based on email address and other profile fields. If integrating with Recruiter System Connect, customers will also be able to link candidates manually using the Profile Plugin embedded in your ATS.

See Sync Candidates for technical details.

Note

Note: Customer manual candidate linking via the Profile Plugin should override LinkedIn's algorithmic matches.

Testing

  • The Profile Plugin embedded in your ATS displays the LinkedIn profile that's correctly matched with a profile in your system
  • Candidate is marked as "in-ATS" in LinkedIn Recruiter
  • Up-to-date candidate data appears in LinkedIn Recruiter's in-ATS indicator

Sync Candidate Notes

Important

Optional for: Recruiter System Connect

What You'll Do

  • When enabling a customer, use the Middleware Platform to send all historical candidate notes in bulk as a one-time process.
  • As candidate notes are created and updated by the customer, use the Middleware Platform to sync these new and updated notes.

See Sync Candidates Notes for technical details.

Testing

  • Up-to-date candidate notes appear in LinkedIn Recruiter's in-ATS indicator

Sync Job Applications

Important

Required for: Recruiter System Connect

What You'll Do

  • When enabling a customer, use the Middleware Platform to send all historical job applications in bulk as a one-time process.
  • As job applications are submitted, updated, or deleted, use the Middleware Platform to sync these new and updated job applications.
  • As candidates apply to jobs, link candidates with job applications
  • Link new job applications with previously submitted job postings using your ATS's identifier.

See Sync Job Applications for technical details.

Testing

  • Up-to-date candidate application data appears in LinkedIn Recruiter's in-ATS Indicator

Sync Job Application Notes & Interview Feedback

Important

Optional for: Recruiter System Connect

What You'll Do

  • When enabling a customer, use the Middleware Platform to send all historical job applications notes and interview feedback in bulk as a one-time process.
  • As job application notes and interview feedback are submitted and updated, use the Middleware Platform to sync these new and updated records.

See Sync Application Notes & Interview Feedback for technical details.

Testing

  • Up-to-date candidate application notes and interview feedback appears in LinkedIn Recruiter's in-ATS Indicator

Sync Job Application Stages

Important

Required for: Recruiter System Connect

What You'll Do

  • When enabling a customer, use the Middleware Platform to send the historical stages of a job application.
  • As job application changes its current stage, use the Middleware Platform to sync these new and updated records.

See Sync Application Stages for technical details.

Testing

  • Up-to-date candidate application stage reflected in LinkedIn Recruiter's in-ATS Indicator

Sync ACLs

Important

Required for: Recruiter System Connect

What You'll Do

  • When enabling a customer, use the Middleware Platform to send all user-level entity security information in bulk as a one-time process.
  • As secured entities are created and updated by the customer, use the Middleware Platform to sync these new and udpated entity/role associations.
  • As users are added to and removed from security groups or roles, use the Middleware Platform to sync these user/role associations.

See ACL Overview for details.

Testing

  • Secured jobs are only visible to the correct users when exporting a candidate in LinkedIn Recruiter
  • Candidate application info for secured jobs are only visible to the correct users when viewing in-ATS indicator in LinkedIn Recruiter