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.
The Ad Preview API offers an organised way to preview a creative using a creative URN. The two types of previews supported are:
Accurate Preview - Preview an existing creative
Live Preview - Preview before creating a creative
Permissions
Permission
Description
rw_ads
Manage and read an authenticated member's ad accounts. Restricted to ad accounts in which the authenticated member has one of the following ad account roles:
ACCOUNT_BILLING_ADMIN
ACCOUNT_MANAGER
CAMPAIGN_MANAGER
CREATIVE_MANAGER
VIEWER
r_ads
Read an authenticated member's ad accounts. Restricted to ad accounts in which the authenticated member has one of the following ad account roles:
ACCOUNT_BILLING_ADMIN
ACCOUNT_MANAGER
CAMPAIGN_MANAGER
CREATIVE_MANAGER
VIEWER
w_organization_social
Post, comment and like posts on behalf of an organization. Restricted to organizations in which the authenticated member has one of the following company page roles:
ADMINISTRATOR
DIRECT_SPONSORED_CONTENT_POSTER
CONTENT_ADMIN
r_organization_social
Retrieve organizations' posts, comments, and likes. Restricted to organizations in which the authenticated member has one of the following company page roles:
ADMINISTRATOR
DIRECT_SPONSORED_CONTENT_POSTER
CONTENT_ADMIN
w_member_social
Post, comment and like posts on behalf of an authenticated member.
r_member_social
(Restricted) Retrieve posts, comments, and likes on behalf of an authenticated member. This is a private permission.
URN of the creative that corresponds to the ad preview.
placement
Placement
Placement on LinkedIn for which the preview is rendered such as Desktop, Mobile etc.
preview
String
HTML when rendered will point to the actual ad preview. This will have an iFrame for Sponsored Content Ads where iFrame parameters will embed the information needed for preview.
Note
X-Restli-Protocol-Version: 2.0.0 must be passed as the header in your API requests
LinkedIn-Version: {yyyymm} must be passed as the header in your API requests as this API is released with Versioning
Accurate Preview
Preview an existing creative. The formats supported are:
Single image ad
Carousel ad
Video ad
Single job ad
Event ad
Get Accurate Preview
Get an accurate preview of the creative by calling the /adPreviews GET API. Partners can embed the iFrame tag returned in the response on their websites and render the preview for both Desktop and Mobile placements.
Note
iFrames returned by the API are valid upto 3 hours. When the iFrame expires, partners can fetch another iFrame by calling /adPreviews API.
GET https://api.linkedin.com/rest/adPreviews?q=creative&creative=urn%3Ali%3AsponsoredCreative%3A123456789&account=urn%3Ali%3AsponsoredAccount%3A123456789
Creative for which preview is to be rendered. Supports preview for creatives referring existing organic post.
You can embed the iFrame tag returned in the response on your websites to render live preview for both Desktop and Mobile placements. Additionally, you can fetch another iFrame live when the creative content is updated by calling above method.
Creative Inline content for which the preview is to be rendered.
Partners can embed the iFrame tag returned in the response on their websites to render live preview for both Desktop and Mobile placements. Partners can fetch another iFrame live when creative inline content is updated by calling above method.
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.
The Ad Preview API offers an organised way to preview a creative using a creative URN. The formats supported are:
Single image ad
Carousel ad
Video ad
Single job ad
Event ad
Permissions
Permission
Description
rw_ads
Manage and read an authenticated member's ad accounts. Restricted to ad accounts in which the authenticated member has one of the following ad account roles:
ACCOUNT_BILLING_ADMIN
ACCOUNT_MANAGER
CAMPAIGN_MANAGER
CREATIVE_MANAGER
VIEWER
r_ads
Read an authenticated member's ad accounts. Restricted to ad accounts in which the authenticated member has one of the following ad account roles:
Ad Preview is currently available to selected Beta Partners only. Please request access to this API by reaching out to your partner technical support channel or https://developer.linkedin.com/support.
Schema
Field Name
Type
Description
creative
SponsoredCreativeUrn
URN of the creative that corresponds to the ad preview.
account
SponsoredAccountUrn
URN of the ad account of the creative.
preview
String
HTML that when rendered will point to the actual ad preview. This will have an iFrame for Sponsored Content Ads where iFrame parameters will embed the information needed for preview.
Field Name
Type
Description
creative
SponsoredCreativeUrn
URN of the creative that corresponds to the ad preview.
preview
String
HTML that when rendered will point to the actual ad preview. This will have an iFrame for Sponsored Content Ads where iFrame parameters will embed the information needed for preview.
Get Ad Preview
Preview a creative calling the /adPreviews API. Partners can embed the iFrame tag returned in the response on their websites to get the preview.
Note
iFrames returned by the API are valid upto 3 hours. When the iFrame expires, partners can get another iFrame by calling /adPreviews API
X-Restli-Protocol-Version: 2.0.0 must be passed as the header in your API requests
LinkedIn-Version: {yyyymm} must be passed as the header in your API requests as this API is released with Versioning
GET https://api.linkedin.com/rest/adPreviews?q=creative&creative=urn%3Ali%3AsponsoredCreative%3A123456789&account=urn%3Ali%3AsponsoredAccount%3A123456789
Learn how to enhance the user experience of declarative agents by using Adaptive Cards to render API data visually. Create and configure Adaptive Card templates, integrate them into API plugins, and test the setup in Microsoft 365 Copilot. Learn the practical steps for building and previewing Adaptive Cards in Visual Studio Code.