Create Apply Connect Jobs

As part of LinkedIn's Apply Connect offering, the SimpleJobPostings API is used to create a new job posting. This API also allows the client to enable onsite application collection via webhook based mechanism.

About Recruiter System Connect or Premium Job Posting

If you have a Recruiter System Connect or Premium Job Posting integration with us, you are already using this API for syncing Jobs to LinkedIn. However, you need to provide additional fields for Apply Connect jobs as described in the sections below. This is because LinkedIn hosts the application experience for Apply Connect jobs on its own platform and delivers the applications to its partners as opposed to PJP jobs or RSC jobs (which may or may not even be posted on LinkedIn).

Requirements

• If you have an Apply Connect integration, please continue to maintain XML Feeds
• Ensure job Ids (externalJobPostingId or companyJobCode) match across XML feed / career sites and API jobs.
• Ensure data parity for jobs, syncing all available data on external career sites / XML feeds.
• Once one job is sent via API, all open, public jobs must be sent via API.

• LinkedIn will inform you once all customers are migrated to API and when to disable the XML Feeds (typically around 3 months after GA).

Job Posting Field Schema

In order to publish an onsite enabled job, you need to construct the request body with all required fields for Simple Job Posting schema. Additional fields are required for onsite enabled jobs. To know more, refer to Onsite Apply Schema.

This API utilizes the onsiteApplyConfiguration field that you can use to specify the questions that need to be answered to complete the job application and host the application experience entirely on LinkedIn. In addition to the questions, you should specify a webhook URL against field jobApplicationWebhookUrl where LinkedIn will POST job applications.

API Endpoint

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

Sample Request

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

Sample Request Body

{
 "elements": [
  {
   "externalJobPostingId": "external-job-id-0001",
   "title": "Test Job",
   "description": "Lorem Ipsum is simply. . .",
   "integrationContext": "urn:li:organization:1234",
   "listedAt": 1558045934000,
   "jobPostingOperationType":"CREATE",
   "location": "Enterprise, UT",
   "availability": "PUBLIC",
   "industries": [
    "urn:li:industry:3"
   ],
   "categories": [
    "advr"
   ],
   "trackingPixelUrl": "http://localhost:5000/jobs/tracking",
   "companyApplyUrl": "http://localhost:5000",
   "posterEmail": "test@email.com",
   "onsiteApplyConfiguration": {
    "jobApplicationWebhookUrl": "https://customer-webhook.com/api/webhook",
    "questions": {
     "voluntarySelfIdentificationQuestions": {},
     "educationQuestions": {
      "educationExperienceQuestionSet": {}
     },
     "workQuestions": {
      "workExperienceQuestionSet": {}
     },
     "additionalQuestions": {
      "customQuestionSets": [
       {
        "repeatLimit": 1,
        "questions": [
         {
          "required": true,
          "partnerQuestionIdentifier": "question1",
          "questionText": "Please choose the right answer",
          "questionDetails": {
           "multipleChoiceQuestionDetails": {
            "choices": [
             {
              "symbolicName": "wrong",
              "displayValue": "This is the wrong answer"
             },
             {
              "symbolicName": "right",
              "displayValue": "This is the correct answer"
             },
             {
              "symbolicName": "right2",
              "displayValue": "This is also the correct answer"
             }
            ],
            "selectMultiple": false,
            "defaultValueSymbolicName": "right",
            "preferredFormComponent": "DROPDOWN",
            "favorableMultipleChoiceAnswer": {
             "favorableSymbolicNames": [
              "right",
              "right2"
             ]
            }
           }
          }
         }
        ]
       }
      ]
     }
    }
   }
  }
 ]
}

Sample Response Body

A successful request will return a 200 OK response code, and you will find the simpleJobPostingTask in the response body. Since Job Postings API is asynchronous, you can refer to Check Job Operation Task Status for task status.

Sample Response for Success

{

 "elements": [
 {
  "location": "/simpleJobPostings/urn%3Ali%3AsimpleJobPostingTask%3A413d-954e-9b3ed6af71ba",
  "status": 202,
  "id": "urn:li:simpleJobPostingTask:c9f5-413d-954e-9b3ed6af71ba"
 }
 ]
}

Apply Connect Jobs Lifecycle

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

• CREATE
• CLOSE
• UPDATE
• RENEW

For all the above operations, value for jobPostingOperationType field in API schema determines the operation to be performed. In order to update a job posting you can re-post the job with jobPostingOperationType as UPDATE. You can also re-post the job with jobPostingOperationType as RENEW to extend its life by 30 days. To close a job, re-post the job with jobPostingOperationType as CLOSE.

Sample Response for Error

{
  "elements": [
    {
      "error": {
        "message": "ERROR :: /onsiteApplyConfiguration/questions/additionalQuestions/customQuestionSets/0/questions/0/partnerQuestionIdentifier :: field is required but not found and has no default value\n",
        "status": 422
      },
      "status": 422
    }
  ]
}

HTTP Status Codes and Errors

LinkedIn provides standard HTTP status codes and clear messages to help you easily understand errors.

When Apply Connect task status is FAILED, then errorCode and errorMessage are also present in the response.

Continue Apply Connect Development

• Check Job Posting Status module.