Conversation Ads


Deprecation Notice
The Marketing version 202302 (Marketing February 2023) and below has been sunset and the unversioned APIs are going to 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.

A Conversation Ad is a LinkedIn ad format that allows advertisers to deliver pre-determined messages to an inbox of a targeted LinkedIn member. It provides a chat-like experience between both the member and the advertiser. The Conversation Ads API allows advertisers to deliver customizable, branded messages directly to members' LinkedIn messaging inboxes.

Within our API, Conversation Ads are represented by the Sponsored Conversation entity. Sponsored Conversations are composed of Sponsored Message Content.

Create a Conversation Ad

  1. Create an Ad Campaign.
  2. Create a Sponsored Conversation.
  3. If you use attachments in a conversation, upload SponsoredMessageContent Asset to the Images API using these steps.
  4. Create a tree of SponsoredMessageContent to represent a conversation.
  5. Update SponsoredConversation with reference to the first SponsoredMessageContent.
  6. Create an AdInMailContent using GuidedReplies as sub-content by using the Urn of the completed Sponsored Conversation.
  7. Create a DRAFT conversation ad creative. See Create a Conversation Ad.
  8. Test the DRAFT conversation ad.
  9. Make any necessary modifications based on testing.


    The creative should be in DRAFT status.

  10. Activate the creative by updating the creative status to ACTIVE.


    The creative will be directed to the review queue after activation.

Help Articles