Job Posting Schema
This document lists and describes the job fields supported by the Job Posting API.
Foundation Schema
The schema below includes attributes required for posting jobs on LinkedIn. The foundation schema represents the core schema that has to be implemented irrespective of integration type. The partner needs to implement the Foundation schema and can also build any extension schema(s) which are defined in the topics below.
Poster Provided Compensation Schema
| Field | Description | Type | Required |
|---|
| compensations | Compensation detail | Array of compensation | Yes |
Compensation Schema
| Field | Description | Type | Required |
|---|
| amount | The amount of compensation. | MoneyAmount | No |
| value | The compensation amount, which may be either "range" or "exactAmount" | MoneyAmountRange | Yes |
| period | Period in which the amount of compensation is paid. Valid value is YEARLY , MONTHLY , SEMIMONTHLY , BIWEEKLY , WEEKLY , DAILY , HOURLY | String | Yes |
| type | Type of compensation, valid value are BASE_SALARY , TIPS , COMMISSION , PROFIT_SHARING , STOCK_OPTIONS , STOCK , BONUS , SIGN_ON_BONUS , OVER_TIME , OTHER | String | Yes |
Money Amount Schema
| Field | Description | Type | Required |
|---|
| currencyCode | ISO currency code. | String | Yes |
| amount | The amount of money as a real number string | String | Yes |
Money Amount Range Schema
| Field | Description | Type | Required |
|---|
| start | Represents the inclusive (greater than or equal to) value in which to start the range. This field is optional. An unset field indicates an open range; for example, if end is 5, it means everything less than or equal to 5. | MoneyAmount | Yes |
| end | Represents the inclusive (less than or equal to) value in which to end the range. This field is optional. An unset field indicates an open range; for example if start is 2 it means everything greater than or equal to 2. | MoneyAmount | Yes |
Sample Request for compensation
"compensation":< "compensations":[ < "period":"YEARLY", "type":"BASE_SALARY", "value": < "range": < "start":, "end": > > > ] >
"compensation": < "compensations":[ < "period":"YEARLY", "type":"BASE_SALARY", "value": < "exactAmount": > > ] >
Includes additional attributes required or optional for jobs promotion.
| Field | Description | Type | Required |
|---|
| 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: | Contract URN | Yes |
| posterEmail | Represents valid email address of the poster who will publish the job. Must be the primary email address of the seat holder as defined in the customer's contract. If not provided, the defaultJobPoster configured by the customer is used | String | No |
| showPosterInfo | Represents whether LinkedIn would display the poster information on job description page. The default value is false (No). For Basic jobs this only works if posterEmail is provided and can be associated to a contract seat holder | Boolean | No |
Note It is mandatory to provide the value of listingType field as PREMIUM.
Recruiter System Connect and CRM Connect Extension Schema
Includes additional attributes required or optional for Recruiter System Connect (RSC) and CRM Connect.
| Field | Description | Type | Required |
|---|
| availability | Valid values are PUBLIC or PRIVATE_TO_ATS_INTEGRATION . Must be PUBLIC for Apply Connect and Premium jobs | String | Yes |
| requisitionOwnerEmail | Email of the requisition owner | String | No |
| requisitionOwnerLastName | Last name of the requisition owner | String | No |
| requisitionOwnerFirstName | First name of the requisition owner | String | No |
Note For Partner ATS who have also integrated for Recruiter System Connect, it is a requirement that they make it optional for customers to choose whether to sync jobs as Private(PRIVATE_TO_ATS_INTEGRATION) or Public.
Apply Connect Extension Schema
Includes additional attributes required or optional for Apply Connect
| Field | Description | Type | Required |
|---|
| onsiteApplyConfiguration | Information required to configure job applications to be collected on LinkedIn | Onsite ApplyConfiguration | Yes |
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 |
|---|
| , | Bold / strong |
| Underline |
| Italic |
| Line break |
| Paragraph |
| Unordered list |
| List element |
