Linkedin Marketing API Updates & Release Notes

Product & Platform Announcements

• Predictive Audiences API: id field available in the response:

Starting version 202607, fetching a Predictive Audience (single or list) now returns its read-only id. Partners can now obtain the id for audiences created in Campaign Manager or the API, and use it to update them.

• Conversions API: New user identifier available for matching:

A new optional user identifier SHA256_IP_ADDRESS is available in the userIds object in the Conversion Event User Schema for /rest/conversionEvents to match with the hashed IP address of the user using SHA256. This update is available on all active versions. This is in addition to the existing PLAINTEXT_IP_ADDRESS already available in plain text format. Currently, only IPv4 addresses are supported.

• Create and Manage Campaigns: creativeSelection in SPONSORED_INMAILS type campaigns with LEAD_GENERATION objective for Message & Conversation Ads:

Starting July 2026, the adCampaigns API will support, as the default, OPTIMIZED for creativeSelection in SPONSORED_INMAILS type campaigns (Message Ads and Conversation Ads) with the LEAD_GENERATION objective. Previously, this combination was rejected with a 400 validation error and forced to ROUND_ROBIN. If your integration creates or updates SPONSORED_INMAILS campaigns with the LEAD_GENERATION objective without explicitly setting creativeSelection, the behavior will default to OPTIMIZED starting with the July 2026 release and will apply to all versions. To preserve even ad rotation, explicitly set creativeSelection as ROUND_ROBIN. Note: OPTIMIZED is only valid for the SPONSORED_INMAILS type with the LEAD_GENERATION objective — all other objectives in this type still reject it with a 400 error.

Product & Platform Announcements

• Company Intelligence API: 365-Day Lookback and Company Attribute Decoration:

Starting with the version 202606, the /accountIntelligence endpoint adopts the following changes:

• filterCriteria.lookbackWindow: A new value LAST_365_DAYS is now supported alongside the existing LAST_7_DAYS, LAST_30_DAYS, LAST_60_DAYS, LAST_90_DAYS, and LAST_180_DAYS. When supplied, engagement and conversion metrics are aggregated over the trailing 365 days from the data calculation date, giving partners a full year of engagement history per target company. Versions 202605 and earlier continue to cap the window at 180 days.

• companySize: A StaffCountRange enum field representing the range of the number of staff employed by the target company. Possible values are: SIZE_1, SIZE_2_TO_10, SIZE_11_TO_50, SIZE_51_TO_200, SIZE_201_TO_500, SIZE_501_TO_1000, SIZE_1001_TO_5000, SIZE_5001_TO_10000, and SIZE_10001_OR_MORE. The field is response-only, included in the default projection, and defaults to $UNKNOWN when the target company has not declared a staff size.

• industry: An IndustryUrn field identifying the industry the target company is associated with based on its primary business activities and products (e.g., urn:li:industry:1). The field is response-only, included in the default projection, and defaults to urn:li:industry:0 when no industry has been assigned.

• countryCode: A string field representing the ISO country code of the target company's headquarters (e.g., "US", "GB"). The field is response-only, included in the default projection, and defaults to an empty string when the headquarters country is not available.

• costInLocalCurrencyPerPaidQualifiedLead: A double type field representing the cost per paid qualified lead (CPQL) attributed to the target company, in the advertiser's local currency. Derived as the ratio of total ad spend over the number of paid qualified leads collected from members of the target company within the lookback window. The field is response-only, included in the default projection, and defaults to 0.0 when no paid qualified leads have been attributed to the target company within the lookback window.

• Dynamic UTM API: Added dynamic tracking parameter support for CREATIVE_NAME:

Starting with the version 202606, the /adTrackingParameters endpoint now supports CREATIVE_NAME in addition to existing parameter values in dynamicTrackingParameters field. This will allow advertisers to track creative names along with their creative ID using Dynamic UTM that uses placeholder parameters which are automatically replaced with relevant values when an ad is served. Within Campaign Manager, this is already available within the URL tracking parameters under the Placement tab as {{CREATIVE_NAME}}.

• Conversation Ads API: Not Interested Call-to-Action (CTA):

A Not Interested CTA is automatically rendered on the firstMessageContent for SponsoredConversations. The CTA is applied to new and existing ads at render time and is not exposed in the API. Use test sends to preview the behavior. For ads created from Campaign Manager, GET requests to /conversationAds/{sponsoredConversationURN}/sponsoredMessageContents will now return a new NOT_INTERESTED value in the replyType field.

• Message Ads API: Not Interested Call-to-Action (CTA):

A Not Interested CTA is automatically rendered on Message Ads. The CTA is applied to new and existing ads at render time and is not exposed in the API. Use test sends to preview the behavior.

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.

• Member Post Statistics API and Member Video Statistics API: Starting with the 202605 version, the /memberCreatorPostsAnalytics and /memberCreatorVideoAnalytics endpoints change the format of metricType in the response body from object to string to simplify parsing.

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

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.

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

Starting with the 202605 version, the /memberCreatorPostsAnalytics and /memberCreatorVideoAnalytics endpoints change the format of metricType in the response body from object to string to simplify parsing.

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:

1. adTargetingFacet: Retrieves the full list of available buyer group segments.
2. 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.

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.

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.

Product & Platform Announcements

• Predictive Audiences API: Create High-intent, AI-powered Custom Audiences

The Predictive Audiences API allows customers to combine their own data with LinkedIn's AI to build audiences tailored to business needs, improving campaign efficiency.

• Ad Lift Tests API: Ad Lift Test Measurement by Campaign Groups

Supports specifying multiple campaign groups when creating a new ad lift test for more detailed measurement.

• Lead Sync API: Dynamic URL Tracking Parameters on Lead Gen Forms

Hidden fields now support dynamic URL tracking parameters for better campaign tracking and integration with CRM.

• Member Authentication: Google and Apple Sign-In for Developer Applications

Starting December 2, 2025, LinkedIn supports Sign in with Google and Apple in addition to the OAuth 2.0 standard login.

Product & Platform Announcements

• Company Intelligence API: Prove Business Impact with Company-level Insights

Allows partners to surface company-level engagement across paid and organic LinkedIn touchpoints for analysis of B2B buying decisions.

• Ad Lift Tests API Updates:

  • adLiftTests API includes a new optional field, reviewInfo, indicating if test content is under review or rejected.

  • adLiftTestResults API includes demographic breakdowns by member ad format and placement domain.

• Ad Analytics API: Dwell Time Metric Update

Improved accuracy of averageDwellTime metric resulting in higher reported dwell time for ads, with historical data refreshed.

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.