Share via

Job Posting Field API Schema

  • Article

This document lists and describes the job fields supported by the Premium Job Posting API.

The documentation for this page is obsolete. Please refer to the Job Posting Field Schema for current schema information.

Field Description Type Required
integrationContext Represents the organization this job posting is created for. Must be in the format urn:li:organization:{organization id} URN No
contract Represents the contract this job posting is published to, which is signed by the customer with LinkedIn to use LinkedIn Recruiter services. Must be in the format urn:li:contract:{contractId} Contract URN No
companyApplyUrl Where to redirect applicants to in order to apply for the job String No
externalJobPostingId Represents unique job id within the applicant tracking system. Do not send an empty or null string for this field String Yes
companyJobCode Represents job posting id within the company’s system for reference. Should be used only when the unique ID for a job in your system is different from the unique ID of the job as in the customer's platform where the job originated. Do not send an empty or null string for this field String No
jobPostingOperationType Represents the operation on the job posting. Available operation options are: CREATE, UPDATE, RENEW, CLOSE String No
title Represents the title of the job posting that will be published. Character limit: 200 String Yes
description Represents the job description including the job basic information, responsibility etc. Character limit: 100 ~ 25,000, limited set of HTML tags accepted (details below) String Yes
skillsDescription Represents desired skills and experiences of the job position. Limited set of HTML tags accepted (details below) String No
listingType Represents the type of this job posting to be published. For premium job posting, this field is a constant string PREMIUM String No
listedAt Represents initial date the job posting was added into the application tracking system. The date is epoch timestamp in milliseconds (UTC) Integer Yes
workRemoteAllowed Represents whether this job posting supports remote work option. The value for the location field should be provided as the company headquarters location. Remote jobs can be posted on country/region level hence just country/region name will suffice in the location field. The default value is false Boolean No
location Represents the geographic location of the job position to hire. Please use one of the below recommended formats:
  • "CITY, STATE, COUNTRY"
  • "CITY, STATE"
  • "CITY, PROVINCE"
  • "CITY, COUNTRY"
  • "POSTALCODE, COUNTRYCODE".
  • "COUNTRY" (accepted only for Remote jobs)
  • "COUNTRY CLUSTER" (accepted only for Remote jobs)
To know more about 		String Yes
countryCode Represents country code of the job position to hire. See Country Code reference table. String Only if location is not provided
postalCode Represents postal code of the job position to hire. String Only if location is not provided
posterEmail Represents valid email address of the poster who will publish the job. Must be a primary email address of LinkedIn Recruiter seat, who is associated with the contract String No
categories Represents job functions specific to this job (for example Accounting, Marketing, Sales). Category names are predefined by LinkedIn and can be retrieved from Job Functions reference table.
  • If predefined LinkedIn values are provided, they are displayed on the LinkedIn Job Posting
  • If none of the values match our predefined LinkedIn values, we recommend partner to still provide raw values. This allows customers to configure job field processors directly with LinkedIn support
  • If no value is provided, then LinkedIn will infer a value by referencing other fields of the Job Posting
String Array No
industries Represents industries of this job or company. Array element must be quoted and in URN format: "urn:li:industry:{industry_id}". Industry IDs are predefined by LinkedIn and can be retrieved from Industry Codes reference table.
If no value is provided for this field, then industries associated with the LinkedIn company page is used. If this field value is not provided and the company page is also not associated with industries, then the API returns error.		 Array of Industry URN No
employmentStatus Represents employment status of the job position. Available options are: FULL_TIME PART_TIME, CONTRACT, INTERNSHIP, TEMPORARY, VOLUNTEER, OTHER. If predefined LinkedIn values are provided, they are displayed on the LinkedIn job posting. If a non-standard value is provided, LinkedIn attempts to standardize and match it to the closest pre-defined value. If no values are provided, LinkedIn standardizes to the closest matched value based on other fields in the job posting String No
experienceLevel Represents experience level of the job position to hire. Available options are: ENTRY_LEVEL, MID_SENIOR_LEVEL, DIRECTOR, EXECUTIVE, INTERNSHIP, ASSOCIATE, NOT_APPLICABLE. If predefined LinkedIn values are provided, they are displayed on the LinkedIn job posting. If a non-standard value is provided, LinkedIn attempts to standardize and match it to the closest pre-defined value. If no values are provided, LinkedIn standardizes to the closest matched value based on other fields in the job posting String No
showPosterInfo Represents whether LinkedIn would show the poster information on job description page. The default value is false Boolean No
trackingPixelUrl URL for the tracking pixel to be embedded on the job description. (for example http://www.trackingpixellocation.com/pixel.gif) String No
requisitionOwnerEmail description comes here type No
onsiteApplyConfiguration Information required to configure job applications to be collected on LinkedIn. Please refer to OnsiteApplyConfiguration field schema for details OnsiteApplyConfiguration No
state description comes here type No
availability Valid values are PUBLIC or PRIVATE_TO_ATS_INTEGRATION. Must be PUBLIC for Apply Connect enabled jobs String No
companyName The company name for which this job posting is created for. This field should be used in lieu of integrationContext only if the company is not a LinkedIn customer with access to the onboarding widget String No
requisitionOwnerLastName Last name of the requisition owner String No
requisitionOwnerFirstName First name of the requisition owner String No
expireAt The date when a job should expire and no longer be available to users. This date should be greater than the current date. If this field is not provided, the default expiration is 180 days. For PREMIUM jobs, the expiration date defaults to the LinkedIn customer's contract settings (generally 30 days) Epoch in Milliseconds (UTC) No

HTML Tags

The following HTML tags are supported for description and skillsDescription fields. Other HTML tags will be stripped out, and their contents will be displayed as plain text.

HTML Tag Description
<b>, <strong> Bold / strong
<u> Underline
<i> Italic
<br> Line break
<p> Paragraph
<ul> Unordered list
<li> List element