Pay For Performance (P4P) Job Posting

The LinkedIn's Pay For Performance (P4P) Job Posting enables posting of P4P jobs to LinkedIn from external solutions. P4P Job Posting is an extension of LinkedIn's Job Posting, and the job posting API request format is a superset of the format used for Promoted Jobs unless you are ingesting jobs via XML feed.

What To Expect

Implementation requirements vary depending on your offering and objectives:

• For any partners, to view your P4P jobs and budgets, you will need to configure the P4P Reports API. This API has a similar usage to Check Job Posting Statuses API which you can also check the status of the posted jobs with externalJobPostingId or partnerJobCode, if applicable. You can find sample API requests from the "Try in Postman" collection above. You will need to join the LinkedIn Workspace and be approved to access it. Each partner will be requested to create a LinkedIn Developer Application to be the master or parent key of any LinkedIn Talent Solutions API integrations. With this key, you will be able to generate child applications with the Provisioning API to represent each client configuration within your partnership ecosystem. Please find a diagram below for a visual aid. To self-provision and activate each child app to be ready for posting or managing jobs or campaigns, you will need to call Provision Customer Hiring Contracts API.
• If you are a Job Distributor (JD) or ATS partner who allows customers to buy individual job advertisements on Job Boards, you will need to add PayForPerformanceTotalBudget to your job posting request as in the Job Posting Schema with Pay For Performance (P4P) Extension. To learn more about how to post P4P jobs via API, please proceed to the section Sample Request for P4P Job Posting API below. Note that P4P Job Campaign API is NOT used to manage individual job advertisements.
• If you are a Recruitment Advertising Agency (RAA) partner that posts jobs on behalf of customers via Campaigns, you will need to understand the P4P Job Campaign API to set up. A campaign is a series of goals that allow the sharing a single theme for more organized job management and related communications. It lets you group and strategize your customers' jobs and their budgets. Regardless of whether you post jobs via XML or API, campaign creation and maintenance should be handled by this API. If you post jobs via XML feed, please move on to the P4P Job Campaign API for your next step, and skip the Sample Request for P4P Job Posting API below. Keep in mind that, in your XML feed, you will need to add up to 3 fields to support P4P-specific job management as you can find them under Pay For Performance (P4P) Jobs XML Extension Schema. If you post jobs via API, please proceed to the section Sample Request for P4P Job Posting API below with the extended schema. Make sure that the contract and expireAt fields work differently in RAA than the rest of the Job Posting products as described in the Sample Request Body for Job Creation Note.

To help understand here is a brief diagram of what the Parent-Child Developer Application relationship is like and how to activate your customer per product:

Once development is ready for certification, please contact your Partner Solutions Engineer and Business Development contacts to setup a meeting.

Sample Request for P4P Job Posting API

In order to post a job as P4P, you need to provide listingType field value as PREMIUM with the right contract.

curl --location --request POST 'https://api.linkedin.com/v2/simpleJobPostings' \
--header 'Authorization: Bearer {access_token}' \
--header 'x-restli-method: batch_create'

Sample Request Body for Job Creation

Standard Job Creation

{
   "elements":[
      {
         "integrationContext": "urn:li:company:{your_company_id}",
         "contract": "urn:li:contract:{your_contract_id}",
         "companyApplyUrl": "https://careers.yourcompany.com",
         "externalJobPostingId": "PromotedJobPostingG1TC1",
         "companyJobCode": "ATS-SourceID_or_externalJobPostingId_of_this_job",
         "posterEmail": "poster@linkedin.com",
         "jobPostingOperationType": "CREATE",
         "title": "Promoted 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>",
         "listedAt": 1513756352000,
         "location":"San Francisco, CA",
         "industries": [
            "urn:li:industry:55"
         ],         
         "budget": {
            "payForPerformanceTotalBudget": {
             "currencyCode": "USD",
             "amount": "275.00"
            }
         },
         "listingType": "PREMIUM"
      }  
   ]
}

RAA Job Creation

{
   "elements":[
      {
         "integrationContext": "urn:li:company:{your_company_id}",
         "companyApplyUrl": "https://careers.yourcompany.com",
         "externalJobPostingId": "PromotedJobPostingG1TC1",
         "companyJobCode": "ATS-SourceID_or_externalJobPostingId_of_this_job",
         "posterEmail": "poster@linkedin.com",
         "jobPostingOperationType": "CREATE",
         "title": "Promoted 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>",
         "listedAt": 1513756352000,
         "location":"San Francisco, CA",
         "industries": [
            "urn:li:industry:55"
         ],
         "listingType": "PREMIUM",
         "partnerJobCampaignId": "abcd1234"
      }  
   ]
}

Sample Request Body for Job Upgrade

Simple Job Posting (SJP) API supports an update of the created jobs, too. This is not a P4P-specific operation, and one can find general guidelines and expectations on the Update and Renew Jobs page. For P4P, if you have free/Basic jobs with LinkedIn, too, you can upgrade them to P4P jobs via this update operation. Please use Check the Job Operation Task Status API to check the asynchronous operation status as you do for regular API-posted jobs.

{
   "elements":[
      {
         "integrationContext": "urn:li:company:{your_company_id}",
         "contract": "urn:li:contract:{your_contract_id}",
         "companyApplyUrl": "https://careers.yourcompany.com",
         "externalJobPostingId": "UpgradeJobPostingG1TC1",
         "posterEmail": "poster@linkedin.com",
         "jobPostingOperationType": "UPDATE",
         "title": "Upgraded 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>",
         "listedAt": 1705648400000,
         "location":"San Francisco, CA",
         "industries": [
            "urn:li:industry:55"
         ],         
         "budget": {
            "payForPerformanceTotalBudget": {
             "currencyCode": "USD",
             "amount": "275.00"
            }
         },
         "listingType": "PREMIUM"
      }  
   ]
}

Sample Request Body for Job Downgrade

One can also downgrade a P4P job to the free/Basic job with the same update operation as you do to upgrade. Please use Check the Job Operation Task Status API to check the asynchronous operation status.

{
   "elements":[
      {
         "integrationContext": "urn:li:company:{your_company_id}",
         "contract": "urn:li:contract:{your_contract_id}",
         "companyApplyUrl": "https://careers.yourcompany.com",
         "externalJobPostingId": "DowngradeJobPostingG1TC1",
         "posterEmail": "poster@linkedin.com",
         "jobPostingOperationType": "UPDATE",
         "title": "Downgraded Free 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>",
         "listedAt": 1705648400000,
         "location":"San Francisco, CA",
         "industries": [
            "urn:li:industry:55"
         ],         
         "listingType": "BASIC"
      }  
   ]
}

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
        }
    ]
}

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 like an example below.

{
   "elements": [
      {
      "error": {
         "message": "ERROR :: /title :: field is required but not found and has no default value\n",
         "status": 422
      },
      "status": 422
      }
   ]
}

API Error Details

In addition to the regular errors you can encounter with /simpleJobPostings, you can have more errors and validations specific to P4P.