Job Posting API
LinkedIn's Job Posting API enables authorized third parties such as clients, ATS systems, and job distributors to post jobs directly to LinkedIn on behalf of customers. This guide details on how to integrate with LinkedIn's Jobs Posting API.
The below button will take you to LinkedIn's Postman's workspace. Select the workspace with name LinkedIn Talent Solutions. You will find the Job Posting API collection in it. Learn more on our Development Tools page.
Job Posting Legal Requirement
Note
- The use of these APIs is restricted to those developers approved by LinkedIn. Please reach out to your LinkedIn Relationship Manager or Business Development contact as you will need to meet certain criteria and sign an API agreement with data restrictions in order to use this integration.
- If you are not yet a LinkedIn Talent Solutions Partner, please complete the LinkedIn Talent Solutions Partner Request Form.
In addition to any restrictions or obligations contained in a signed API agreement, partner:
- Acknowledges that LinkedIn acts as a passive conduit for the online distribution and publication of job listings and LinkedIn is not responsible for screening or monitoring job listings. Jobs posted to the LinkedIn Service (including via the LinkedIn APIs) may be posted only for lawful purposes by individuals and employers seeking employees. The LinkedIn APIs may not be used to post job listings that violate the restrictions included in the LinkedIn Jobs Terms and Conditions
- Will ensure that its customers agree to the LinkedIn Jobs Terms and Conditions prior to posting any jobs to the LinkedIn Service via partner’s application and shall have a method of keeping track of which of its customers have agreed to the LinkedIn Jobs Terms and Conditions and when, and shall furnish such information to LinkedIn upon request
- Shall not market any job listings to be distributed via LinkedIn or its syndication network as a "free way to post jobs to LinkedIn" or anything substantially similar in any marketing or sales materials
- Acknowledges that in some cases, we may require certain types of jobs to be promoted on LinkedIn. Jobs that require promotion may include jobs by companies with generic names (such as “Confidential Company”). These limits are designed to prevent abuse, improve product quality, and increase transparency while ensuring that job seekers have access to the best possible opportunities. Please note that LinkedIn reserves the right to require promotion of jobs.
Development Milestones
Request Access
Before beginning development, you will need to be provisioned access to test resources, and your API applications will have to be enabled to access the job posting API endpoints. You can request access by completing the following steps:
Create API applications for the integration. You may create two API applications per integration - one for production, and another for development and testing. Please contact your LinkedIn Business Development point of contact and request to fill out the Partner Onboarding Form.
After the above steps, you are guided with test environment details that can be consumed for your development and testing. In order to test these APIs we will set up test organization which you can use to create and update test jobs. Please note that any jobs created to this page will be frequently closed and you should expect jobs created to this test organization to be short-lived.
Begin Development
Once your application is configured, you may begin making API requests and testing the integration.
In order to post jobs on behalf of customers, you may need to create a child API Key. Refer to Create and Configure Customer Application to know the steps. LinkedIn's Job Posting API follows Rest.li standards and requires OAuth. To learn more about Job Posting API, refer to Sync Basic or Promoted Jobs.
You can post any of the below two job categories:
Basic Jobs - These are job posts aggregated on LinkedIn to create a comprehensive job-seeking experience for LinkedIn members. These jobs receive limited active promotion to members as compared to jobs posted in Job Slots (paid jobs). To post basic jobs refer to:
Promoted Jobs - These are jobs posted in Job Slots as paid jobs. For customers with paid job slots, the API allows posting jobs directly into their Job Slots. To post promoted jobs refer to:
If you are an Apply Connect partner then you can use Job Posting API to also enable onsite apply. To create Apply Connect jobs refer to
- Job Postings API Overview and Create Apply Connect Jobs
- Foundation Schema, Apply Connect Extension Schema and OnsiteApplyConfiguration Schema
Create and Configure Customer Applications
If you are a LinkedIn Partner (for example, Applicant Tracking System or Job Distributor) implementing Job Posting for multiple customers, please follow below steps to complete the Job Posting Integration.
- Create and configure a customer(child) application for posting jobs on behalf of customer. The Provisioning API allows you to create API keys for each of your customers using the parent application provisioned by LinkedIn
- Once you have created customer application, you will need to store the
API Key(client id for the customer application created by Provisioning API) and a LinkedIn Developer Application id for each of your customers. You should also persist the companyID (and contractID for Promoted Jobs Extension Schema) as provided by the customers when opting for posting jobs on LinkedIn - For existing customers of Recruiter System Connect, Apply with LinkedIn or Apply Connect you will be using their existing customer API keys
Important
We expect partners to create only one application per customer account on your platform and use it to make all API calls such as Job Postings, RSC and Apply Connect. The customer account and its corresponsding application created via Provisioning API should strictly have 1:1 mapping.
ATS Customer Onboarding
In order to enable Job Posting for a Recruiter customer, your application requires implementing an onboarding widget to collect below essential details to post a job.
| Field | Note |
|---|---|
| organizationId | The LinkedIn company page ID of LinkedIn Recruiter customer |
| contractId | The contract ID of LinkedIn Recruiter customer. This is required only for posting paid jobs |
Below Help Article links can be shared to help customers find their Contract and Company ID:
- For Company ID refer to this help center
- For Contract ID refer to this help center
Note
- The value of
integrationContextfield will be urn:li:organization:"organizationId" - For Recruiter System Connect customers,
integrationContextis provided by ATS customer onboarding widget. To know more, refer to Recruiter System Connect's Customer OnBoarding - For others, the value of
integrationContextfield can be constructed manually if the customer provides value fororganizationId. In absence of this value, provide the company information viacompanyNamefield - Contract ID field is mandatory for Premium job postings
View Job Posting on LinkedIn
When a customer posts a job on clients or ATS systems which are integrated with the Job Posting API, the job is published on LinkedIn and is associated company page on LinkedIn. It is similar to manually posting jobs in New Recruiter and Jobs
Frequently Asked Questions
Refer to FAQ document for most commonly asked questions.
Announcements and Releases
All the changes that are continuously being made to LinkedIn's Job Posting documentation can be tracked in the section for Annoucements and Release Notes.