Linkedin Marketing API Release Notes

Product & Platform Announcements

• Ad Analytics API: New Event and Video Watch Time metrics available
  Starting with the 202601 version, we have introduced two sets of new metrics to be returned for /AdAnalytics endpoint: EventWatchTime metrics and VideoWatchTime metrics.
  For events, API partners can now measure eventViews, eventWatchTime, averageEventWatchTime and costPerEventView, plus thresholded variants for audiences who watched over 15 seconds, 30 seconds, or 2 minutes. These signals help advertisers better understand audience quality and downstream engagement beyond basic view counts, making it easier to evaluate which events and audiences are driving meaningful attention.
  For video, the videoWatchTime and averageVideoWatchTime metrics are now available. These metrics provide additional data on the duration that sponsored videos are viewed, supporting more detailed analysis of video engagement and viewer retention.

• Breaking Changes
  The monthly API versions below will be sunset and removed from the platform on the dates listed. To avoid disruptions to your platform, please migrate to the latest API version launched today.

• 202501 - Jan 15, 2026

• 202502 - Feb 16, 2026

• 202503 - Mar 16, 2026

Product & Platform Announcements

• Predictive Audiences API: Create High-intent, AI-powered Custom Audiences
  The Predictive Audiences API allows the customers to combine their first-party or third-party data with LinkedIn's predictive AI modeling to build audience segments tailored to specific business needs. Customers can use company or contact lists as a seed source to identify prospects who are likely to engage and have high conversion propensity, improving campaign efficiency. Leverage it to automate audience expansion for bottom-funnel advertising strategies such as account-based marketing, re-engagement of valuable accounts, and activate AI-scored segments for customer campaigns and advertising workflows.
  The Predictive Audiences API is a private API available to developers with access to the Matched Audiences API. To request access, first submit an application for the Advertising API with an ads management or reporting use case. After approval, you can request access via the form here. For more information, refer to the developer documentation here and product spotlight here.

• Ad Lift Tests API: Ad Lift Test Measurement by Campaign Groups
  The Ad Lift Tests API supports specifying multiple campaign groups in the liftEntity field when creating a new ad lift test using POST /adLiftTests. This enables measurement of the lift for specified campaign groups. Measurement of an individual campaign group is also supported through this field.

• Lead Sync API: Dynamic URL Tracking Parameters on Lead Gen Forms
  Hidden fields for Lead Gen Forms support dynamic URL tracking parameters, enabling automatic tracking of campaigns, creatives, and other sources to associate leads with a particular lead gen form. Dynamic URL tracking parameters allow advertisers to avoid duplicating forms due to static field limitations and integrate these fields with CRM or marketing automation platform for enhanced reporting and attribution. This improves overall campaign effectiveness. Customers gradually get access to the feature, with the 100% ramp planned for December 10, 2025. Learn more here.

• Member Authentication: Google and Apple Sign-In for Developer Applications
  Starting December 2, 2025, LinkedIn will support Sign in with Google and Sign in with Apple as new options for member authentication in developer applications, alongside the existing username/password method for OAuth 2.0 authorization requests. When users are redirected from your application to LinkedIn’s login page to see these additional choices and can select either to proceed. This experience will be available only on Desktop and Android web browsers.
  If your application uses the standard OAuth specification to initiate OAuth, signing in with Google or Apple should work without issues. To verify, please follow the instructions here to test these login options for your application. Additionally, note that the current login method (username/password) remains unchanged and will continue to function as usual. For further details, refer to the Authorization Code Flow documentation. If you wish to disable these login options for your developer application, submit a Zendesk request to the LinkedIn support team.

Breaking Changes

The monthly API versions below will be sunset and removed from the platform on the dates listed. To avoid disruptions to your platform, please migrate to the latest API version launched today.

• 202411 - Nov 17, 2025
• 202501 - Jan 15, 2026
• 202502 - Feb 16, 2026

Product & Platform Announcements

• Company Intelligence API: Prove Business Impact with Company-level Insights
  Newly launched Company Intelligence API enables partners to surface company-level engagement across paid and organic LinkedIn touchpoints. By consolidating signals at the company level, the API supports analysis of B2B buying decisions across multiple stakeholders and long sales cycles. Metrics include engagement score, paid impressions, paid clicks, leads, organic impressions, and organic engagements. The API supports attribution and analytics solutions, allowing integration of LinkedIn insights with CRM and analytics platforms and connecting engagement data to business outcomes such as pipeline and revenue.
  This is a private API available to qualified developers who meet additional access criteria. For more details, see the developer documentation here and product spotlight here. To apply for access, submit your request here.

• Ad Lift Tests API Updates:

  • Ad Lift Test Schema: Starting with the 202510 version, the adLiftTests API includes a new optional field, reviewInfo, for Ad lift tests. This field indicates if the test content is under review, accepted, or rejected, and, if rejected, specifies the reasons. The reviewInfo field is absent if the Ads Review Team has not reviewed the test.
  • Ad Lift Test Results: Starting with the 202510 version, the adLiftTestResults API includes demographic breakdowns of ad lift test results by MEMBER_AD_FORMAT, MEMBER_AD_FREQUENCY_RANGE, and MEMBER_AD_PLACEMENT_DOMAIN (Feed, LinkedIn Audience Network, Connected TV). Ad lift metrics can be segmented by ad format, impression frequency range, and placement domain using the API.

• Ad Analytics API: Dwell Time Metric Update
  We recently improved the accuracy of the averageDwellTime metric in the adAnalytics API, which measures the duration that more than 50% of an ad’s pixels remain visible in the viewport. With this updated methodology, reported Dwell Time may increase by approximately 25%, especially for in-feed and First Impression ads. Six months of historical data will be refreshed by October 16, 2025, to ensure consistency.
  No action is required from partners or customers. We recommend updating any previously exported reports that include Dwell Time to align with the updated data. This enhancement provides precise engagement insights to support performance analysis and campaign optimization.

• OAuth Token Usage: Monitor activity in the LinkedIn Developer Portal
  Starting September, the LinkedIn Developer Portal's Analytics dashboard includes a feature that lets developers monitor refresh token requests made by their applications. This update adds the ability to view OAuth token usage statistics for your application. To view this data, go to the Analytics tab in your developer application and look for OAuth Token Usage at the bottom. Note that daily statistics reset at midnight UTC.

• LinkedIn Ads Agreement: Updates to Improve Ad Performance
  LinkedIn is expanding its use of Microsoft data and customer tag data, which provide professional and B2B signals. This will help advertisers enhance their targeting, optimize campaigns with precision, and drive performance across the funnel. In addition, LinkedIn’s Ad Agreement will be updated on November 3, 2025, to state that LinkedIn and its affiliates, including Microsoft, may use Audience Data to improve advertising services. There will be no changes to APIs or partner integrations. For more details, please visit the Help Center.

Breaking Changes

The monthly API versions below will be sunset and removed from the platform on the dates listed. To avoid disruptions to your platform, please migrate to the latest API version launched today.

• 202410 - Oct 15, 2025
• 202411 - Nov 17, 2025

Product & Platform Announcements

• Ad Account Trust Preferences API: Manage Publisher Restrictions at the Ad Account level. Starting with the 202509 version, we have introduced a new endpoint /adAccountTrustPreferences in the Advertising API that allows you to create and manage ad publisher restrictions at the ad account level. This endpoint can be used to apply or remove ALLOWLIST and BLOCKLIST of publishers for ad accounts, or to view the current ALLOWLIST and BLOCKLIST at the account level. Any ALLOWLIST/BLOCKLIST applied to an ad account will automatically apply to all new and existing campaigns within that account.

• Rate Limit Alert Notifications The LinkedIn Developer Platform has introduced a new email alert when your app reaches 75% of its daily application-level rate limit quota. The alert is designed to help you monitor and manage your API usage. All developer app admins will receive these emails which include details about their app(s), its client ID, the timestamp when the threshold was breached, the resource, method, and usage information as an attachment. For more details, see here.

Breaking Changes

The monthly API versions below will be sunset and removed from the platform on the dates listed. To avoid disruptions to your platform, please migrate to the latest API version launched today.

• 202409 - September 15, 2025
• 202410 - October 15, 2025
• 202411 - November 17, 2025

Product & Platform Announcements

• Campaigns API: Political Advertising Declaration for EU-Targeted Campaigns.
  Starting October 10, 2025, advertisers running campaigns targeting the EU region must self-declare if their ads qualify as political advertising under the EU's Transparency and Targeting of Political Advertising (TTPA) regulation. To facilitate this action, Campaign Management partners are now required to implement a self-declaration step in the LinkedIn campaign creation flow for campaigns targeting the EU region. Partners must pass back this information with LinkedIn via the politicalIntent field in the /adCampaigns schema.
  Although LinkedIn prohibits political advertising and will continue to do so, this update is required to ensure regulatory compliance and maintain a trusted platform for our members and customers.

• Conversions API Payload Builder: Enhanced Validation & Direct API Call Support.
  The Conversions API Payload Builder now supports capabilities to enable seamless and efficient integration process for Conversions API. Developers can build and validate syntactically correct /conversionEvents payloads, auto-generate JSON or cURL formats, and test them directly on LinkedIn Developer Portal via the new "Make an API Call" feature.
  This self-serve feature streamlines development effort by enabling OAuth access token generation through either a developer's own app (if API access is provisioned) or a LinkedIn-owned app. Refer to the technical documentation for implementation details.

• Developer AI Chatbot: Now on the LinkedIn Developer Website.
  Our AI-powered chatbot support has expanded from the Developer platform to the LinkedIn Developer website, making it easier for developers to discover and learn more about LinkedIn API products and access relevant technical information to get started.

Breaking Changes

The monthly API versions below will be sunset and removed from the platform on the dates listed. To avoid disruptions to your platform, please migrate to the latest API version launched today.

• 202408 - Aug 18, 2025
• 202409 - Sep 15, 2025
• 202410 - Oct 15, 2025
• 202411 - Nov 17, 2025

Product & Platform Announcements

• Creatives API: Support for Innovid VAST Tags in Video Ads for CTV.
  Starting with the 202507 version, partners can utilize VAST tags to streamline the setup and asset management of Connected TV (CTV) ad campaigns. The content field in the Creatives API schema now includes a new field, thirdPartyVastTagVideoAd, where you can provide a vastTagUrl from a third-party VAST tag vendor hosting the video content. Currently, only Innovid VAST tags are supported.
  VAST tags enhance efficiency of CTV campaigns by simplifying asset delivery and allowing for more creative flexibility, testing, and reporting. For complete CTV specifications, refer to the CTV Ads Specifications.

Breaking Changes

The monthly API versions below will be sunset and removed from the platform on the dates listed. To avoid disruptions to your platform, please migrate to the latest API version launched today.

• 202407 - Jul 22, 2025
• 202408 - Aug 15, 2025
• 202409 - Sep 15, 2025

Product & Platform Announcements

• Member Follower Statistics API:
  Power your platform by integrating LinkedIn’s member follower statistics API to report insights on gained member followers for authenticated members and motivate members to create high-quality content on LinkedIn. Community Management API partners can now retrieve the total follower count of authenticated members from a new endpoint

GET /memberFollowersCount

that supports two query finders: q=me to query life-time followers count (starting with the 202504 version), and q=dateRange, to query time-bound followers count by date range (starting with the 202505 version). This API requires additional member consent from a new permission called r_member_profileAnalytics, which is included in the Community Management API. This endpoint is a “member profile” version of a similar endpoint for “organization”

GET /organizationalEntityFollowerStatistics

• Member Post Statistics API:
  Power your platform by integrating LinkedIn’s member post statistics API to report insights on member single post performance, as well as aggregated member posts, and motivate members to create high-quality content on LinkedIn. Community Management API partners can now retrieve IMPRESSION, MEMBERS_REACHED, REACTION, COMMENT, or RESHARE of either a single member post or all aggregated posts of authenticated members, from a new endpoint,

GET /memberCreatorPostAnalytics

that supports two query finders: q=me, to query aggregated member posts statistics, and q=entity, to query a single member post statistics (starting with the 202506 version). This API requires additional member consent from a new permission called r_member_postAnalytics, which is included in the Community Management API.

• Member Video Statistics API:
  Power your platform by integrating LinkedIn’s member video statistics API to report insights on video performance of the member post and motivate members to create high-quality video content on LinkedIn. Community Management API partners can now retrieve VIDEO_PLAY, VIDEO_WATCH_TIME, or VIDEO_VIEWER of a single member video post from a new endpoint,

GET /memberCreatorVideoAnalytics

that supports one query finder q=entity to query a single member video post statistics (starting with the 202506 version). This API requires additional member consent from a new permission called r_member_postAnalytics, which is included in the Community Management API.

Breaking Changes

The monthly API versions below will be sunset and removed from the platform on the dates listed. To avoid disruptions to your platform, please migrate to the latest API version launched today.

• 202406 - Jun 16, 2025
• 202407 - Jul 22, 2025
• 202408 - Aug 15, 2025

Product & Platform Announcements

LinkedIn Events Enhancements

• Events Management API: Create LinkedIn Live Test Events. Partners can now create LinkedIn Live Events on their customer's LinkedIn company page for testing purposes using a new optional field called testEvent in the request schema for POST /events. The default value is set to false, and when set to true, if the event organizer is an organization, the event is treated as a test event visible only to that organization's page admins or those with a direct URL to the event page.
  Test events allow organizers to test connecting their live stream to their LinkedIn event without broadcasting to company page followers, preventing LinkedIn members from discovering it, receiving notifications, or accidentally joining. This setting can only be specified during event creation, and the visibility of the event can't be changed afterward.

• Creatives Management API: Add Video Preview to Event Ads. The POST /creatives endpoint now supports Event Ad creatives. For promoted LinkedIn Live events with registration forms, you can specify whether to display a video preview in the ad using the event ad boolean property hidePreviewVideo. This field is optional and defaults to false, which plays a 30-second preview of the event livestream or recording before viewers are asked to register.
  Providing a preview of the event content before requiring registration has been shown to increase views and registration submission rates. If an advertiser chooses to fully gate an event behind a registration form, the value of this property can be changed to true for existing creatives through partial-update requests. By changing this value to true, the target audience will be required to register for the event before seeing any part of the live stream or event recording.
  Learn more about how our new Event API offerings unlock the power of event marketing and help your customers stand out in the current landscape of B2B events with an elevated strategy and approach.

• Ad Analytics API: Launching Revenue Attribution Metrics
  We are excited to announce the availability of key business outcome metrics through the Ad Analytics API, enabling partners to demonstrate LinkedIn’s impact, optimize sales and marketing strategies, and enhance lower funnel efficiency and effectiveness. Starting with the 202505 version, by using the new query finder q=attributedRevenueMetrics on GET /adAnalytics endpoint for ACCOUNT, CAMPAIGN_GROUP, CAMPAIGN pivots, partners can provide a real-time view of LinkedIn’s influence on CRM events, such as the number of CRM leads, pipeline value, and revenue, to their customers.
  Additionally, we have introduced a new object revenueAttributionMetrics in the response schema, which includes several new fields for revenue attribution metrics for accounts that have connected their CRM with LinkedIn. We support CRM connections with Dynamics 365, Salesforce, and HubSpot.

• Conversions API: Support for 365-day Lookback Window
  The Conversions API now allows you to set a 365-day conversion lookback window for postClickAttributionWindowSize and viewThroughAttributionWindowSize when creating a new conversion rule with POST /conversions for the following conversion types: SUBMIT_APPLICATION, PURCHASE, ADD_TO_CART, QUALIFIED_LEAD, and LEAD. For all other conversion types, allowed values remain the same (1, 7, 30, 90 days). We recommend using a longer conversion window to capture and attribute conversions from longer B2B sales cycles and ensure accurate attribution for infrequent conversions. This update has been released to all active versions.

• Add Business Email to LinkedIn Application: Do not miss critical LinkedIn communications
  We are pleased to share that partners can now add their preferred business email address to their LinkedIn application to stay informed about critical LinkedIn Developer platform and product updates, including migration or deprecation notices, new APIs, or changes to current APIs. This ensure you don't miss important LinkedIn communications, preventing interrupted service, broken integrations, or loss of functionality.

• Verified on LinkedIn Pilot: Add LinkedIn Verification to your Platform
  Partners now have the ability to leverage LinkedIn verification through Verified on LinkedIn feature. This enables their users to showcase their LinkedIn verification status on the partner platform, helping companies and users benefit from communities with known identities that foster trust and drive engagement. We are currently accepting requests to onboard new platforms. Submit your request here.

• Ad Account Users API Updates:

  • Find Ad Account Users by Accounts Update: The GET /adAccountUsers endpoint with the q=accounts query parameter now limits user searches to only one ad account. It return matching results for only the first ad account ID, even if multiple ad account IDs are provided in the accounts query parameter. This change in behavior applies to all previous versions.
  • Unversioned Ad Account Users API Sunset: Starting from July 1st 2025, the deprecated unversioned API for Ad Account Users will be sunset. Please note that any calls to the API will return a 4xx error. You are recommended to use the versioned Ad Account Users API for continued access.

Breaking Changes

The monthly API versions below will be sunset and removed from the platform on the dates listed. To avoid disruptions to your platform, please migrate to the latest API version launched today.

• 202405 - May 15, 2025.
• 202406 - Jun 16, 2025
• 202407 - Jul 15, 2025

Product & Platform Announcements

• Campaign Groups API: Campaign Group Budget Optimization With Daily Budget.
  Starting with the version 202504, we’ve added an optional dailyBudget field to the campaign group object in the request payload for POST /adCampaignGroups. This enhancement allows you to set or update the daily budget at the campaign group level via API, similar to LinkedIn Campaign Manager. When BudgetOptimizationStrategy = DYNAMIC is applied to a campaign group, budget optimization will be performed at the group level, and the daily budget will be shared among all campaigns within the campaign group.

• Posts API: Support for Buy/Shop Now Call to Action.
  Starting with the version 202504, partners can read and create Buy/Shop Now call to action (CTA) via the Posts API. Ecommerce advertisers frequently use this type of CTA to encourage their target audience to purchase their product or service. When contentCallToActionLabel is available, "BUY_NOW" and "SHOP_NOW" will be eligible inputs.

Breaking Changes

The monthly API versions below will be sunset and removed from the platform on the dates listed. To avoid disruptions to your platform, please migrate to the latest API version launched today.

• 202504 - Apr 15, 2025
• 202505 - May 15, 2025.
• 202506 - Jun 16, 2025

Product & Platform Announcements

Conversions API Enhancements:

• Access Token Generation in Campaign Manager for Direct API: Advertisers that directly send their conversions data to LinkedIn Conversions API without integrating through supported partner platforms will now have the ability to generate access tokens for authentication directly from their Campaign Manager Ad Account. They will no longer be required to create a developer application and apply to Conversions API. The generated access tokens will have no expiry. Learn more.
• Build Payload with ease: We are making it easy for developers to build the payload body of /conversionEvents endpoint and bring the auto formatted, syntactically correct json/CURL to the API call. This aims to reduce developer's effort to build the payload, minimize the number of errors a developer would encounter and make integration effort seamless & efficient.

Ad Targeting Entities API: Filter Geographies Eligible for CTV-Only Campaigns.

Starting with the 202503 version, we have introduced a new optional field useCase in the typeahead finder of the Ad Targeting Entities API. This update also includes the CONNECTED_TELEVISION_ONLY_CAMPAIGN value, which allows filtering for geo-targeting entities eligible for CTV-only campaigns. Utilizing this field will help you automatically align with LinkedIn’s CTV supported geo locations when changes are made.

Breaking Changes

The monthly API versions below will be sunset and removed from the platform on the dates listed. To avoid disruptions to your platform, please migrate to the latest API version launched today.

• 202504 - Apr 15, 2025
• 202505 - May 15, 2025.
• 202506 - Jun 16, 2025