Update and Renew Jobs

Set the value for for jobPostingOperationType to UPDATE or RENEW to perform the respective job operation.

Note

The latest API version is 202604. Use this version in the LinkedIn-Version header for all API requests to access the most recent features and improvements.

API Overview

Use the /simpleJobPosting API to create, update, renew and close jobs on LinkedIn. This wiki describes how to update and renew 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/rest/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.

Sample Request for Update Jobs

In order to update a simple job posting, you can just re-post the job with any changed information and jobPostingOperationType field value set as UPDATE. To know the API Endpoint, Authorization and Throttling refer to Post Jobs on LinkedIn

Refer to Check the Job Operation Task Status for finding the status of update call.

Note

For basic jobs synced for Recruiter System Connect, if you need to update the availability from PUBLIC to PRIVATE_TO_ATS_INTEGRATION for a job, please close the existing job and re-open with the desired availability.

Expiration Date Rules

• Use the UPDATE operation to extend a job’s expiration date (where allowed).
• UPDATE cannot be used to refresh a job’s listing date.
• Attempts to use UPDATE for listing refresh will result in errors.

Expiration Date Behavior

Job Product	Allowed Operation	Behavior
Limited Listing (Basic)	UPDATE	Can set expireAt. If not provided, defaults to 180 days. Max allowed is 365 days.
Slot-based Premium	UPDATE	Can set expireAt. If not provided, defaults to 180 days. Max allowed is 365 days.

API Header

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

Sample Request Body

{
   "elements":[
      {
         "externalJobPostingId":"PremiumJobPostingSMM01",
         "title":"Social Media Management",
         "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:{contract_id}",
         "company": "urn:li:company:{company_id}",
         "companyApplyUrl": "http://linkedin.com/jobpostingSMM01",
         "listingType":"PREMIUM",
         "jobPostingOperationType":"UPDATE",
         "location":"San Francisco, CA",
         "posterEmail":"recruiter_email@yourcompany.com"
      }
   ]
}

Note

When updating jobs,

• you may extend the expiration date (expireAt) only for Limited Listing (Basic) and Slot-based Premium jobs.
• maximum allowed expiration is 365 days. If no expireAt is provided, the default is 180 days.

Error Codes

Given below is a list possible error codes that can display while updating 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 make sure 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 :: /{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	Enure 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
400	400	Invalid company apply url for job with externalPartnerId <>, taskUrn <>	The URL specified for the job posting is in an invalid format	Ensure the url specified is in a valid url
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
403	403	Not enough permissions to access: POST /simpleJobPostings	The application does not have enough permissions to use /simpleJobPostings API	Access to /simpleJobPosting is limited and granted only to apps that have a product-relevant use case. Please reach out to LinkedIn via the partner support form to request access
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
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
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

Renew Jobs

Note

To renew a job, re-post it with jobPostingOperationType field as RENEW and no other changes.

As alternatives, you can:

• Close and repost - Close the existing job and repost it with the same externalJobPostingId (in some job products, metrics remain grouped).
• Post new job - Publish a new job with a different externalJobPostingId (treated as a completely new posting).

To learn about the API endpoint, authorization and throttling refer to Post Jobs on LinkedIn

Listing Date Rules

• Use the RENEW operation to refresh a job’s listing date (where allowed).
• RENEW cannot be used to extend a job’s expiration date.
• Attempts to use RENEW for expiration extension will result in errors.

Listing Date Behavior

Job Product	Allowed Operation	Behavior
Limited Listing (Basic)	Not allowed	Attempting RENEW returns error: Only the listing date of promoted jobs can be refreshed.
Slot-based Premium	RENEW	Can refresh listing date only if current listing date ≥ 30 days.