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
posterEmailfield 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
- Be sure to check the response for error statuses corresponding to individual entities you submit
- The Task ids returned in the above response are valid for 24 hours
- Check the Job Operation Task Status to find the status of the job posting via above task ids
- The value of
integrationContextfield is obtained from customer onboarding widget. To know more, refer to Apply Connect's Customer OnBoarding or Recruiter System Connect's Customer OnBoarding. If this value is not present please provide the company information viacompanyNamefield
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 |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for