Close Jobs

To close a job, re-post the job using the same externalJobPostingId value, but set jobPostingOperationType to CLOSE.

API Overview

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

Sample Request for Premium Jobs

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": [
        {
            "listingType": "PREMIUM",
            "companyApplyUrl": "http://localhost:0000",
            "contract": "urn:li:contract:{{contract_id}}",
            "industries": [
                "urn:li:industry:55"
            ],
            "externalJobPostingId": "TEST_150421",
            "description": "Lorem Ipsum is simply dummy text of Lorem Ipsum.",
            "listedAt": 0123456789,
            "title": "JOB_1_TEST_150421",
            "integrationContext": "urn:li:organization:{{company_id}}",
            "location": "San Francisco, California",
            "jobPostingOperationType": "CLOSE"
        }
    ]

Error Codes

Given below is a list possible error codes that can display while closing 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. 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 following CREATE, UPDATE or CLOSE
401	401	Invalid access token	Access token is tampered	Regenerate a new access token
401	401	The token used in the request is expired	The access token used in Authorization header is a valid token but it has expired	Regenerate a new access token
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
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