Dela via


Create Jobs

To create a job, post the job by providing unique externalJobPostingId value and set the jobPostingOperationType as CREATE.

API Overview

Use the /simpleJobPosting API to create, update, renew and close jobs on LinkedIn. This wiki describes how to create jobs. To know more about this API, refer to API Overview.

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.

Note

  • Ensure that requests do not include duplicate updates to the same externalJobPostingId
  • The maximum number of jobs which can be submitted during one batch call is 100. If you would like to submit more than 100 jobs at a time, please group your jobs in to collections of 100 and make multiple batch calls in sequential order

Sample Request for Basic Jobs

In order to publish a job as a free job, you need to provide listingType field value as BASIC.

API Header:

The header for making the request is X-Restli-Method: batch_create.

Authorization: Bearer {token}
x-restli-method: batch_create

Sample Request Body:

{
 "elements": [{
   "integrationContext": "urn:li:organization:2414183",
   "companyApplyUrl": "http://linkedin.com",
   "description": "We are looking for a passionate Software Engineer to design, develop and install software solutions. Software Engineer responsibilities include gathering user requirements, defining system functionality and writing code in various languages. Our ideal candidates are familiar with the software development life cycle (SDLC) from preliminary system analysis to tests and deployment.",
   "employmentStatus": "PART_TIME",
   "externalJobPostingId": "1234",
   "listedAt": 1440716666,
   "jobPostingOperationType": "CREATE",
   "title": "Software Engineer",
   "location": "India",
   "workplaceTypes": [
    "remote"
   ]
  },
  {
   "integrationContext": "urn:li:organization:2414183",
   "companyApplyUrl": "http://linkedin.com",
   "description": "We are looking for a passionate Software Engineer to design, develop and install software solutions. Software Engineer responsibilities include gathering user requirements, defining system functionality and writing code in various languages. Our ideal candidates are familiar with the software development life cycle (SDLC) from preliminary system analysis to tests and deployment.",
   "employmentStatus": "PART_TIME",
   "externalJobPostingId": "1234",
   "listedAt": 1440716666,
   "jobPostingOperationType": "CREATE",
   "title": "Software Engineer",
   "location": "San Francisco, CA",
   "workplaceTypes": [
    "hybrid"
   ]
  },
  {
   "integrationContext": "urn:li:organization:2414183",
   "companyApplyUrl": "http://linkedin.com",
   "description": "We are looking for a passionate Senior Software Engineer to design, develop and install software solutions. Software Engineer responsibilities include gathering user requirements, defining system functionality and writing code in various languages. Our ideal candidates are familiar with the software development life cycle (SDLC) from preliminary system analysis to tests and deployment.",
   "employmentStatus": "PART_TIME",
   "externalJobPostingId": "789",
   "listedAt": 1440716666,
   "jobPostingOperationType": "CREATE",
   "title": "Senior Software Engineer",
   "location": "San Francisco, CA"
  }
 ]
}

Note

The first element in the above request body is an example of posting a remote job on LinkedIn (workplaceTypes is remote, note that the location field has only COUNTRY value) and the second element is an example of posting a hybrid job (workplaceTypes is hybrid). In the third element, since no value for workplaceTypes field is provided, the job will get posted as an On-site job.

Sample Request for Promoted Jobs

In order to post a job as promoted, you need to provide listingType field value as PREMIUM.

Note

Only selective partners have the permission to post promoted jobs. If your developer application does not support posting promoted jobs, reach out to LinkedIn's business development point of contact (if interested).

API Header

Authorization: Bearer {access token}
X-restli-method: batch_create

Sample Request Body

{
   "elements":[
      {
         "externalJobPostingId":"PremiumJobPostingG1TC1",
         "listingType":"PREMIUM",
         "title":"Premium Job Posting G1 TC1",
         "description":"<b>Objective of the Position</b><br/> <ul> <li>To develop digital content plan, manage and monitor different content executions for social and online platforms to maximize the communication effectiveness and impact</li> <li>To manage, monitor and keep optimizing the performance of social platforms of MB and AMG</li> <li>To monitor and manage internet word of mouth to keep the health of brand and product image</li></ul>",
         "contract":"urn:li:contract:{your_contract_id}",
         "integrationContext":"urn:li:organization:{your_organization_id_01}",
         "companyApplyUrl": "http://linkedin.com/jobpostingG1TC1",
         "location":"San Francisco, CA",
         "listedAt":1513756352000,
         "jobPostingOperationType":"CREATE"
      },
      {
         "externalJobPostingId":"PremiumJobPostingG1TC2",
         "listingType":"PREMIUM",
         "title":"Premium Job Posting G1 TC2",
         "description":"<b>G1 TC2: Objective of the Position</b><br/> <ul> <li>To develop digital content plan, manage and monitor different content executions for social and online platforms to maximize the communication effectiveness and impact</li> <li>To manage, monitor and keep optimizing the performance of social platforms of MB and AMG</li> <li>To monitor and manage internet word of mouth to keep the health of brand and product image</li></ul>",
         "contract":"urn:li:contract:{your_contract_id}",
         "industries":["urn:li:industry:4", "urn:li:industry:99"],
         "integrationContext":"urn:li:organization:{your_organization_id_02}",
         "companyApplyUrl": "http://linkedin.com/jobpostingG1TC2",
         "location":"San Francisco, CA",
         "listedAt":1513756352000,
         "jobPostingOperationType":"CREATE",
         "posterEmail":"stub@your_poster_email_address"
      }
   ]
}

Note

  • Ensure that requests do not include duplicate updates to the same externalJobPostingId
  • To post promoted jobs it is mandatory to provide contract information. If the posterEmail field is not provided the job is be posted on behalf of the default job poster email configured by recruiter customers

Sample Request for Internal Only Jobs

In order to post a job as internal only, you need to provide availability field value as INTERNAL.

Note

Only selective partners have the permission to post promoted jobs. If your developer application does not support posting promoted jobs, reach out to LinkedIn's business development point of contact (if interested).

API Header

Authorization: Bearer {access token}
X-restli-method: batch_create

Sample Request Body

{
   "elements":[
      {
         "externalJobPostingId":"PremiumJobPostingG1TC1",
         "listingType":"BASIC",
         "title":"Job Posting G1 TC1",
         "description":"<b>Objective of the Position</b><br/> <ul> <li>To develop digital content plan, manage and monitor different content executions for social and online platforms to maximize the communication effectiveness and impact</li> <li>To manage, monitor and keep optimizing the performance of social platforms of MB and AMG</li> <li>To monitor and manage internet word of mouth to keep the health of brand and product image</li></ul>",
         "contract":"urn:li:contract:{your_contract_id}",
         "integrationContext":"urn:li:organization:{your_organization_id}",
         "companyApplyUrl": "http://linkedin.com/jobpostingG1TC1",
         "location":"San Francisco, CA",
         "listedAt":1513756352000,
         "jobPostingOperationType":"CREATE",
         "availability": "INTERNAL"
      }
   ]
}

Note

  • Ensure that requests do not include duplicate updates to the same externalJobPostingId
  • To post internal jobs it is mandatory to provide contract information.

Sample Response Body

Below are the response body examples for success and error scenarios:

Sample Response Body for Success

A successful request returns a 200 OK response code, and you will find the simpleJobPostingTaskIDs in the response body.

{
    "elements": [
        {
            "id": "urn:li:simpleJobPostingTask:03ff7ca6-dedf-4d92-b856-10669f8fe5ef",
            "status": 202
        },
        {
            "id": "urn:li:simpleJobPostingTask:01c922a8-96cd-4c32-8cc1-40eea169fe01",
            "status": 202
        }
    ]
}

Sample Response Body for Error

In case of an error, the request will return a 200 OK response code and the error message is within the response body.

{
 "elements": [{
  "error": {
   "message": "ERROR :: /title :: field is required but not found and has no default value\n",
   "status": 422
  },
  "status": 422
 }]
}

Note

How to Test

To test and view the public jobs that were successfully posted, use your integrationContextid to view the job here: https://www.linkedin.com/jobs/search/?f_C={id}&locationType=Y. For jobs posted with an availability set to PRIVATE_TO_ATS_INTEGRATION, login to your Recruiter platform with development contract and use the One-Click Export feature.

API Error Details

Click to view a list of possible API error codes that can display while creating a job.

One of the following responses is returned, that contains a JSON object with a status and a message about the error for Post on /simpleJobPostings.

HTTP CODE RESPONSE STATUS ERROR MESSAGE DESCRIPTION RESOLUTION
200 422 ERROR :: /{mandatory key} :: field is required but not found and has no default value Required field is missing in the request body Refer to the schema documentation and ensure all the required fields are present in the request body
200 422 ERROR :: /{attribute_name} :: {value} cannot be coerced to Long\n", (Why is \n coming in error message) When value of the attribute does not match the datatype it accepts. For example, title accepts String but we have provided numerical value Ensure that the value provided for attribute should match the datatype it accepts. Please refer to schema documentation for data types of the attributes
200 422 ERROR :: /jobPostingOperationType :: "UPDATED" is not an enum symbol\n Wrong value provided for the field jobPostingOperationType The value should either be one of CREATE, UPDATE or CLOSE
200 400 The workplaceTypes field cannot have more than one value provided. Provided values [..] workplaceTypes field accepts an array of only one element, but the request contains more than one elements for workplaceTypes field Ensure that workplaceTypes field is an array with only one element (one of the following: On-Site, Hybrid, Remote)
400 400 Invalid company apply url for job with externalPartnerId {externalJobPostingId}, taskUrn urn:li:simpleJobPostingTask:{taskID} The URL specified for the job posting is in an invalid format Ensure the url specified is in a valid url
400 400 Either context or company or companyPageUrl or companyName must be provided Integration context company field is missing All jobs are associated with company page. You can provide this value with either of the schema fields listed in the error messages
401 401 Invalid access token Access token is tampered Regenerate a new access token
401 401 The token used in the request has expired The access token used in Authorization header is a valid token but it has expired Regenerate a new access token
402 402 Insufficient job slots for contract = urn:li:contract:{contract_id} for purchase flow All job slots associated with the supplied contract are used Please ask the customer to reach out to LinkedIn's customer support to purchase more Job Slots with LinkedIn or Close some existing Premium Job Postings to free up Job Slots. To know more refer to LinkedIn help center article. If this issue is occurring frequently in your development environment please create a ticket on Zendesk Platform
402 402 Insufficient lifetime budget for contract: urn:li:contract:{contract_id} For FP4P jobs PAYMENTS_INSUFFICIENT_FUNDS contract has exhausted allocated budget for premium job posting. Contract monthly limits can be setup within LinkedIn Recruiter Please validate contract limit per month or sufficient balance before posting a premium job
403 403 Caller is not authorized to access the jobs for contract: urn:li:contract:{contract_id} The application used for posting premium job does not belong to the Job posting contract 1. Ensure that you are using the correct contract details provided in the Premium Job Posting onboarding email
2. Ensure that you are using the correct application credentials
403 403 Not enough permissions to access: POST /simpleJobPostings The application does not have enough permissions to use /simpleJobPostings API Ensure that the header x-restli-method with value batch_create is present
403 403 Unpermitted fields present in REQUEST_BODY: Data Processing Exception while processing fields [/elements] Value for Request Header: x-restli-method: batch_create is not provided Ensure that value for Request Header: x-restli-method: batch_create is provided
403 403 Caller is not authorized to access the fp4p contract Customer is unable to post premium jobs after widget opt-in Pay for performance contract customers need to enable toggle for posting of promoted jobs with a LinkedIn recommended budget using the Job Posting API (Partner Integrations)
403 403 Not enough permissions to access: POST (Name) Access token is generated from the application which does not have permission to access this resource Use Partner application for creating child application, all other resources should be requested using child applications
404 404 Resource (Name) does not exist API URL format is incorrect Please verify the URL format from documentation and sample code
409 409 Cannot close job which is already closed or does not exist The request payload is trying to close a job which either does not exist or is already closed Ensure that the jobPostingOperationType value is CREATE while creating new job postings
422 422 ERROR :: /employmentStatus :: {value} is not an enum symbol Wrong value provided for the field employmentStatus The value should either be one of FULL_TIME, PART_TIME, CONTRACT, INTERNSHIP, TEMPORARY, VOLUNTEER or OTHER
422 422 ERROR :: /experienceLevel :: {value} is not an enum symbol Wrong value provided for the field experienceLevel The value should either be one of ENTRY_LEVEL, MID_SENIOR_LEVEL, DIRECTOR, EXECUTIVE, INTERNSHIP, ASSOCIATE or NOT_APPLICABLE
422 422 ERROR :: /state :: {value} is not an enum symbol Wrong value provided for the field state The value should either be one of LISTED or CLOSED
422 422 ERROR :: /{field} :: enum type is not backed by a String Field expects an enum value in the form of String but the value passed is not a string. For example, state : 123 Ensure the Enum value provided is in a String
422 422 The job contains more than seven locations. Please ensure maximum seven locations per job More than seven locations are passed in the alternateLocations field You can add upto seven locations in a single API call
500 500 Internal Server Error When incorrect attribute type is given. For example, Integer instead of String Please check if externalJobPostingId datatype is string in request body
504 504 Gateway Timeout Invalid API request Please recheck all header's and API payload