Training
Learning path
Implement finance and operations apps - Training
Plan and design your project methodology to successfully implement finance and operations apps with FastTrack services, data management and more.
This browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Warning
Deprecation Notice
The Marketing Version 202311 (Marketing November 2023) and earlier versions (excluding 202306 and 202307) have been sunset. Additionally, the unversioned APIs will be sunset soon. We recommend that you migrate to the versioned APIs as well as migrate to the new Content and Community Management APIs to avoid disruptions. See the Migration page for more details.
If you haven’t yet migrated and have questions, submit a request on the LinkedIn Developer Support Portal.
At LinkedIn, we’re continuously evolving our product offerings. It’s important that our API partners are supported in this journey with the tools and experiences that enable them to innovate and deliver the best solutions to our mutual customers.
We understand the value of stable API integrations and the need for clear guidance on planning and making changes to your integrations. You experiment, build, test, and deploy new products all the time.
To support this, we’re introducing API versioning across our LinkedIn Marketing API Program. This will ensure your active integrations continue working while you integrate our latest changes.
LinkedIn’s Marketing APIs first versioned API release was June 2022 under a new base path: https://api.linkedin.com/rest/
Our versioned API releases are on a monthly cycle. There are several subtleties that will be different from the former release cycle:
Legacy (unversioned) Marketing APIs using the base path https://api.linkedin.com/v2/
will soon be sunset.
Some of our legacy APIs (V2) have also been renamed and will be published according to the following table:
Legacy endpoint | Versioned endpoint |
---|---|
/adInMailContentsV2 | /adInMailContents |
/audienceCountsV2 | /audienceCounts |
/adSegmentsV2 | /adSegments |
/adAnalyticsV2 | /adAnalytics |
/sharesV2 | /posts |
/ugcPosts | /posts |
/adAccountsV2 | /adAccounts |
/adAccountUsersV2 | /adAccountUsers |
/adCampaignGroupsV2 | /adCampaignGroups |
/adCampaignsV2 | /adCampaigns |
/adCreativesV2 | /creatives |
/insightTagDomainsV2 | /insightTagDomains |
/adCampaignInsightsV2 | /adCampaignInsights |
API clients will use HTTP headers to indicate the API version. Releases are titled according to the month in which the development work commenced - again, similar to the way we have pushed releases in the past. Comprehensive documentation and change guides will accompany each release. Our versioned Marketing APIs will be supported and stable for a minimum of one year before sunset.
Version Name | Version Header |
---|---|
November 2024 | 202411 |
LinkedIn’s LinkedIn Marketing API Program supports versioning so API partners can release changes over time. This document explains how to use versioned APIs.
LinkedIn makes continuous improvements to our products, and thus our APIs must change too. But we want our API partners to have trust in stable integrations with reliable change schedules so that they can plan and execute better over time.
That’s why we’ve created a stable supported window of one (1) year (minimum) for our Marketing APIs.
HTTP headers will be used for clients to indicate which API version implementation they expect. Include a request header with the key “LinkedIn-Version” and set the value to the version (format: YYYYMM) to correspond with the documentation version you’re referencing, for example - “LinkedIn-Version: 202411” would indicate that you are using the version published in the month of November.
curl -X POST 'https://api.linkedin.com/rest/adCampaigns' \
-H 'Authorization: Bearer {INSERT_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'Linkedin-Version: 202411’ \
--data '{
"account": "urn:li:sponsoredAccount:123212321",
"audienceExpansionEnabled": false,
`}
...
In many cases, the URL resource paths your integration uses may not change across versions, but the behavior of the individual API methods will. For example, there may be new parameters required or new fields available on the response schemas.
The API changes must include the Version Header for the version (release) that needs to be adopted. For example, for the November 2024 LMS Release, the versioned header would be: "LinkedIn-Version": "202411"
Version headers are tied to the LMS Release date:
Version | Version Header Values |
---|---|
November 2024 | "LinkedIn-Version": "202411" |
October 2024 | "LinkedIn-Version": "202410" |
September 2024 | "LinkedIn-Version": "202409" |
Each version of the LinkedIn Marketing API Program has distinct and comprehensive documentation covering all supported APIs. It also includes a changelog indicating all changes from the previous version indicating which resources have been updated or added. Initially, users will have the option on each page in the marketing folder to view: Versioned content: “Marketing {Month} 202X”, or Unversioned content (prior to June 2022) using the dropdown selector.
LinkedIn Marketing API Program will publish new versions monthly, and those versions will be supported for a minimum of one (1) year.
Individual API resources may evolve at different times (e.g. a reporting API may be updated one quarter a year). And each API resource will have its own migration guide to help you navigate major updates.
You could choose to integrate with the newest API changes as soon as they’re released or wait until you’re ready - as long as it’s within the one year change API support window.
LinkedIn expects that our LinkedIn Marketing API Program API partners work to deliver the latest and most valuable experiences to our customers within a reasonable time of their availability. As a result, we will sunset our API versions as early as one (1) year after release.
LinkedIn expects every versioned API call to specify a version; we will not default you to the latest version. It’s important to us that customers have the best possible experience with LinkedIn integrations. And it’s more likely that customers have a great experience when the integration is being regularly maintained (at least once per year).
At times, LinkedIn may need to change APIs within the supported stable window.
LinkedIn reserves the right to release a patch version to any API if required for any critical security or privacy issues or bug fixes. While the likelihood of these scenarios is minimal, we will work closely with partners to minimize the impact of any breaking changes.
You can use any version that hasn’t been sunset. The documentation will reflect all available API versions. Migrating to the latest version, however, comes with two important benefits:
At present these APIs are unversioned, which may be subject to change at any time at the discretion of product ownership teams.
To migrate your app from an older version to a later version, simply update the older version‘s YYYYMM
formatted value in the header to the later version’s value. For example, here’s how you’d migrate from the November 2023 version to the November 2024 version.
-H ‘Linkedin-Version: 202311’ to -H ‘Linkedin-Version: 202411’
Reasons for migrating to a later version include:
While you can migrate to any later version of the API, migrating to the latest version comes with two important benefits:
Training
Learning path
Implement finance and operations apps - Training
Plan and design your project methodology to successfully implement finance and operations apps with FastTrack services, data management and more.