Share via

Create and Manage Video Ads

  • Article

Warning

Deprecation Notice
The Marketing Version 202310 (Marketing October 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.

Video ads help you engage business decision-makers on LinkedIn's mobile and desktop news feed.

You can create video ads in two ways:

  • Post videos to your Company Page and sponsor the post to reach more than just followers. With a Company Page Video, your organization can share a first-hand look into your company culture, products, news, and events to drive further engagement and conversation.
  • Create video ads that bypass Company Page followers and go directly to your news feed.

Video ads must meet the requirements described in Advertising Specifications for Video Ads.

Permissions

Permission Description
w_organization_social Post, comment, and like posts on behalf of an organization. Restricted to the company admin, DSC poster, or content admin.
w_member_social Post, comment, and like posts on behalf of authenticated member.
rw_ads Create ads and creatives for a sponsored account
r_ads Read an authenticated member's Ad Account. 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
    		•

    See Organization Access Control for more information on company page roles.

    Note: There are additional permission checks performed when retrieving or editing a video asset, please see Video API Permissions.

    Schemas

    Familiarize yourself with the following APIs required to create a Video Ad:

    • Videos - upload videos (replaces Assets API)
    • Posts - create posts (User Generated Content) on behalf of an organization or a member
    • Creatives - design creative content for an Ad Campaign

    Create a Video Ad with a New Post

    1. Create an Video campaign. See Video Campaign.

    2. Create a Post using the Video URN in the content field.

    3. Create an Video Creative with the video post. See creatives.

    POST https://api.linkedin.com/rest/posts


    {
   "adContext": {
       "dscAdAccount": "urn:li:sponsoredAccount:508915158",
       "dscStatus": "ACTIVE"
   },
  "author": "urn:li:organization:5515715",
  "commentary": "Sample Video Post",
  "visibility": "PUBLIC",
  "distribution": {
    "feedDistribution": "NONE",
    "targetEntities": [{
                "geoLocations": [
                    "urn:li:geo:103644278"
                ],
                "seniorities": [
                    "urn:li:seniority:3"
                ]
            }],
    "thirdPartyDistributionChannels": []
  },
  "content":{
    "media":{
      "title":"title of the video",
      "id": "urn:li:video:C5F10AQGKQg_6y2a4sQ"
      }
    },
  "lifecycleState": "PUBLISHED",
  "isReshareDisabledByAuthor": true
}

    Sample Response

    A successful response returns a 201 Created HTTP status code and the ID in the x-linkedin-id response header.

    Create a Video Ad with an Inline Post

    You can directly create a sponsored video post that will not show to Company Page followers but will be directly sponsored to target LinkedIn members' news feeds.

    1. Create a Video Campaign. See Video Campaign.

    2. Create an Video Creative with inlineContent. See Video Ad Creative with inlineContent.

    Help Articles