Linkedin Marketing API Updates & Release Notes

Product & Platform Announcements

• Events Management API: Off-Platform Event Support and Required End Dates

  Starting with the 202605 version, the /rest/events endpoint adopts the new Event schema with the following changes:

  • hasDarkUgc: A boolean field indicating whether the event is backed only by a dark UGC post created through sponsored ad workflows. When true, the event has no LinkedIn Events Detail Page and is suppressed from all organic surfaces regardless of discoveryMode. The field is CREATE ONLY and defaults to false for regular page-backed events.
  • endsAt: Now a required field on all event types. Create requests that omit endsAt will be rejected with a validation error. This is a breaking change introduced from 202605; versions 202604 and below continue to treat endsAt as optional.

• Event Ads API: Off-Platform Event Ads and Lead Generation Campaign Objective

  Starting with the 202605 version, the Event Ads API (/rest/adAccounts/{adAccountId}/adCampaigns with format: SPONSORED_UPDATE_EVENT) adds the following capabilities:

  • objectiveType: LEAD_GENERATION is now a supported objective for Event Ad campaigns, alongside the existing BRAND_AWARENESS, WEBSITE_VISITS, and ENGAGEMENT objectives. The referenced event must have a lead gen form attached (event.leadGenForm) and be published (event.ugcPost populated).
  • Off-platform Event Ads: A new end-to-end flow is available for advertisers who want to run Event Ads without a LinkedIn Events Detail Page. Create the backing event with hasDarkUgc: true, then proceed with the standard campaign, dark post, and Event Ad creative steps. The ad redirects to the external URL regardless of event lifecycle stage.

• Conversions API: New user identifiers available for matching, updated required field validation for lead, and a new request parameter to fetch cross-account shared conversion rules

  New optional user identifiers in the userIds object in the Conversion Event User Schema for /rest/conversionEvents to improve match rates and attribution performance. This update is available on all active versions.

  • PLAINTEXT_IP_ADDRESS: IP address of the user in plain text format. Currently, only IPv4 addresses are supported.
  • GOOGLE_AID: The Google Advertising ID (GAID), a unique, user-resettable, and anonymous identifier for Android devices.

  Updated the required field validation in the Conversion Event User Schema for /rest/conversionEvents to allow sending conversion events with only lead as the user identifier. Previously, this returned a 400 validation error. This update is available on all active versions.

  The Find Conversion Rules by Ad Account API on /rest/conversions finder by account now supports an optional array parameter conversionOwnershipTypes accepting two possible values: OWNED and SHARED. The response body includes a new field ownershipType with one of those values in the conversion object. This allows fetching both owned conversions for the ad account and shared conversions across ad accounts within the same Business Manager. If this query parameter is not passed, only OWNED conversions are returned by default, preserving existing behavior for version 202604 and earlier.

• Predictive Audiences API: New method to Get all predictive audiences in the account

  Starting with the 202605 version, the Predictive Audiences API supports the GET_ALL method on /rest/dmpSegments/{dmpSegmentId}/businessObjectiveBasedAudiences, which retrieves all predictive audiences under a given parent DMP segment as a paginated collection.

• Ad Analytics API: New metric available for Appointments Scheduled from Lead Gen Forms

  Starting with the 202605 version, the AdAnalytics API supports a new metric appointmentsScheduled in the response for /rest/adAnalytics. This metric measures the number of appointments booked through Lead Gen campaigns.

• Company Intelligence API: Paid Video Views Metric

  Starting with the 202605 version, the /accountIntelligence endpoint now includes the following new field for campaign insights at the company level:

  • paidVideoViews: A long type field representing the total count of paid video ad views from members of the target company. Counts are aggregated over the window specified in filterCriteria.lookbackWindow. The field is response-only, included in the default projection alongside the existing engagement metrics, and defaults to 0 when no paid video views have been attributed to the target company within the lookback window.

• Change to Developer Support path

  Starting May 15, 2026, contact Developer Support via the Developer Support Request Form. This will be the primary way to reach Developer Support going forward. The Zendesk support path will sunset soon. Use the form for all new requests as we transition.

• Reapply to API Products from your Developer Portal

  Developers can now resubmit expired API access requests (that expire after 21 days) or those declined for insufficient details directly in the Developer Portal. A Reapply CTA replaces "Access denied", reloads the original form for edits, and creates a new case—no need to recreate the app or contact support.

Product & Platform Announcements

• Member Post Statistics: New Creator Analytics Metrics

The /memberCreatorPostAnalytics endpoint now supports new metrics:

• POST_SEND: Number of times post entities were sent via LinkedIn messaging.

• POST_SAVE: Number of times post entities were saved.

• LINK_CLICKS: Number of clicks on links within post entities.

• PREMIUM_CTA_CLICKS: Number of clicks on premium call-to-action buttons.

• FOLLOWER_GAINED_FROM_CONTENT: Number of new followers gained from post entities.

• PROFILE_VIEW_FROM_CONTENT: Number of profile views generated from post entities.

• Company Intelligence API: New 180-Day Lookback Window

Starting with the 202604 version, the /accountIntelligence endpoint now supports a LAST_180_DAYS lookback window, extending the maximum range for filtering impression and engagement data from 90 to 180 days.

• New Integration Requirements Pages

New requirement pages are now available to guide developers on the technical criteria for integrating with LinkedIn Marketing Solutions APIs. These requirements must be met as part of an organization pursuing partner certification.

• Community Management
• Event Management
• Conversions API
• Reporting
• Advertising
• Audience Insights
• Media Planning
• Company Intelligence
• Matched Audiences
• Lead Sync

Product & Platform Announcements

• Member Post Statistics: New Creator Analytics Metrics

The /memberCreatorPostAnalytics endpoint now supports new metrics:

• POST_SEND: Number of times post entities were sent via LinkedIn messaging.

• POST_SAVE: Number of times post entities were saved.

• LINK_CLICKS: Number of clicks on links within post entities.

• PREMIUM_CTA_CLICKS: Number of clicks on premium call-to-action buttons.

• FOLLOWER_GAINED_FROM_CONTENT: Number of new followers gained from post entities.

• PROFILE_VIEW_FROM_CONTENT: Number of profile views generated from post entities.

• Company Intelligence API: New 180-Day Lookback Window

Starting with the 202604 version, the /accountIntelligence endpoint now supports a LAST_180_DAYS lookback window, extending the maximum range for filtering impression and engagement data from 90 to 180 days.

• New Integration Requirements Pages

New requirement pages are now available to guide developers on the technical criteria for integrating with LinkedIn Marketing Solutions APIs. These requirements must be met as part of an organization pursuing partner certification.

• Breaking Changes

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

• Version Sunset

202504 - Apr 15, 2026
202505 - May 15, 2026
202506 - Jun 15, 2026

• Reminders

Member Post Statistics API: New creator analytics metrics

Starting with the 202604 version, the /memberCreatorPostAnalytics endpoint now supports new metrics:

POST_SEND, POST_SAVE, LINK_CLICKS, PREMIUM_CTA_CLICKS, FOLLOWER_GAINED_FROM_CONTENT, PROFILE_VIEW_FROM_CONTENT.

Product & Platform Announcements

• Company Intelligence API: New Qualified Leads and Conversions Metrics

  Starting with the 202603 version, the /accountIntelligence endpoint's response now includes the following new fields for campaign insights at the company level:

  • paidQualifiedLeads: A long value representing the number of qualified leads from the Conversions API attributed to the target company.
  • conversions: A long value representing the count of conversions based on actions performed by a member after viewing or clicking on an ad. This includes both the Conversions API and Insights Tag conversions.

  Both fields are returned by default (included in the default projection) and will be present in the response, returning 0 when no data is available. These metrics correlate qualified leads and conversions with target companies to inform account-based marketing prioritization.

• Lead Sync API: Webhook validation is required for new lead notifications

  Starting March 16, 2026, we are enforcing webhook validation while sending push events for LEAD_ACTION type. New lead notifications will only be pushed to webhooks that have been validated. For more information, refer to the Webhook validation guide and FAQ.

• Ads Targeting Facets API: New Buyer Group Targeting Facet

  The Ad Targeting Facets API introduces a new buyerGroups facet. This feature allows advertisers to target audiences based on predefined buyer group categories. Each buyer group represents a standardized product category (Example: Cybersecurity Software).

  The buyerGroups facet supports the following finders on the /adTargetingEntities endpoint:

  • adTargetingFacet: Retrieves the full list of available buyer group segments.
  • typeahead: Searches for buyer group segments by keyword (Example: Query "software" returns matching product categories).

• Brand Lift Testing API: Maximum of 50 Campaign Groups per Test

  Brand Lift Tests are limited to 50 Campaign Groups maximum upon creation.

Documentation Updates

• Event Management API: Field mutability and lifecycle update restrictions

  The revised Event fields documentation clarifies modification rules by classifying fields as READ ONLY, CREATE ONLY, or UPDATABLE. A critical change is the restriction that no fields, including the event name and description, can be updated after an event has begun. The documentation also indicates that live audio events are a deprecated feature.

Breaking Changes

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

202503 - Mar 16, 2026

202504 - Apr 15, 2026

202505 - May 15, 2026

Product & Platform Announcements

• Videos API: New Media Attribution Fields for Third-Party Integration

  Starting with the 202602 version, we have introduced two optional fields to the /videos endpoint's initializeUploadRequest: templateName and linkbackContext. Developers can now track and attribute videos created using third-party tools, companies, or templates. You can provide attribution metadata using the following optional fields:

  • templateName: A string identifying the name of the template used to create the video (Example: "Sunshine birthday wishes").
  • linkbackContext: A string that provides context for linking back to the original source, such as a URL pointing to the specific template or tool.

  These fields allow downstream systems to identify the source template or tool used during video creation and enable deep linking back to the original resource when needed. When a video is created with these attribution fields, LinkedIn can display the template name and provide a direct link to the source, enabling attribution and allowing advertisers and content creators to reference the tools or templates used during video creation.

• Ad Campaigns API & Ad Budget Pricing API: Qualified leads available as optimization target for Lead Generation campaign objective

  Starting with the 202602 version, we have introduced MAX_QUALIFIED_LEAD as a supported value for optimizationTargetType field used in the /adCampaigns and /adBudgetPricing endpoints when using LEAD_GENERATION as campaign objectiveType. This optimizes lead generation campaigns to target high-quality leads using qualified lead data sent from Conversions API (where conversion rule type must be QUALIFIED_LEAD) or CRM data shared from Business Manager. Learn more 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. For information on all the supported versions, refer to the migrations documentation.

  202502 - Feb 16, 2026
  202503 - Mar 16, 2026
  202504 - Apr 15, 2026

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. For information on all the supported versions, refer to the migrations documentation.

• 202501 - Jan 15, 2026
• 202502 - Feb 16, 2026
• 202503 - Mar 16, 2026

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.

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. For more information, refer to the developer documentation and product spotlight.

• 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 Developer Support 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. For information on all the supported versions, refer to the migrations documentation.

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.

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.

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.

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.

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.