API Overview

The LinkedIn's Job Posting API allows members to automatically post jobs to LinkedIn from their Applicant Tracking System (ATS), instead of manually posting using the website. This API enables partners to post and manage lifecycle for both basic or promoted jobs. The promoted jobs via API get promoted directly to paid job slots of LinkedIn Recruiter customers. Not all partners have the capability to post promoted jobs. To request for access, please reach out to your LinkedIn Business Development point of contact.

Note

If you are not yet a LinkedIn Talent Solutions Partner, please complete the LinkedIn Talent Solutions Partner Request Form

Note

Please note 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”) or jobs from search and staffing companies. 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.

Job Posting API Schema

In order to publish a job, you need to construct the request body with all required fields. The more information your application can provide, the more candidates can be reached to satisfy customers’ needs. To post basic jobs, refer to Foundation schema. To enable advanced features on job posting, refer to Extension schema

Important

For a given customer, when their first job is sent via the SJP API, all the customer’s open, public jobs should be sent via API. All future public jobs should also be sent via API.

Job Posting Operations

Listed below are the four job posting operations supported by LinkedIn:

  1. Create
  2. Close
  3. Update
  4. Renew

Note

  • For all the above operations, value for jobPostingOperationType field in API schema determines the operation to be performed.
  • For example, use jobPostingOperationType as CREATE in request body to create a job.

Post Jobs on LinkedIn

API Endpoint

Use the following endpoint to submit a task to create, close, update, or renew one or more jobs asynchronously:

POST https://api.linkedin.com/v2/simpleJobPostings

API Authorization

All requests below require access tokens obtained via the OAuth2.0 Client Credentials flow.

Important

We strongly recommend to use same access token for all concurrent and consecutive calls. An access token has a lifespan of 30 mins. Only on expiry of the existing token, new token should be generated.

API Throttling

Throttle Limits Requests Per Day (UTC) Records Per Minute Records Per Day
Application maximum 100,000 2,000 (applicable only for Promoted jobs) 60,000 (applicable only for Promoted jobs)

Refer to the below sections for sample requests and responses for each operation type.

Sample Request Body

We have provided below wiki pages to help with API request samples as well as error guide tables based on the following job posting operation type:

Continue RSC Development

In case you are building with RSC program, you can continue developing the remaining modules using RSC Sync Candidates