LinkedIn Use Cases > Conversation Ad > Sponsored Message Contents API

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

Documentation GitHub OpenAPI

Business capability

Digital Marketing Management BC-400.60

Operations 6

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /conversationAds/{conversationAdsId}/sponsoredMessageContents Batch create messages for a conversation ad · LinkedIn Batch Create Sponsored Message Content #

Ask an LLM

“Can I add several messages to a conversation ad at once?”

“What's the way to create the message tree for a sponsored conversation?”

Tell an agent

Batch create sponsored message content for conversation {conversationAdsId}.

Add the new messages to conversation ad {conversationAdsId}.

GET /conversationAds/{conversationUrn}/sponsoredMessageContents/{messageUrn} Get one message from a conversation ad · LinkedIn Get Sponsored Message Content #

Ask an LLM

“Can I read the text of a single message in a conversation ad?”

“Which content does one specific sponsored message hold?”

Tell an agent

Get message {messageUrn} from conversation {conversationUrn}.

Show sponsored message {messageUrn} in {conversationUrn}.

POST /conversationAds/{conversationUrn}/sponsoredMessageContents/{messageUrn} Update one message in a conversation ad · LinkedIn Update Sponsored Message Content #

Ask an LLM

“Can I edit the wording of one message in my conversation ad?”

“Is it possible to change a single sponsored message without touching the others?”

Tell an agent

Update message {messageUrn} in conversation {conversationUrn}.

Rewrite the single sponsored message {messageUrn} of {conversationUrn}.

GET /conversationAds/{conversationUrn}/sponsoredMessageContents Batch get messages in a conversation ad · LinkedIn Batch Get Sponsored Message Content #

Ask an LLM

“Can I fetch several messages from a conversation ad in one call?”

“Which messages make up a given sponsored conversation?”

Tell an agent

Batch get messages {ids} from conversation {conversationUrn}.

Retrieve all listed message contents of {conversationUrn}.

POST /conversationAds/{conversationUrn}/sponsoredMessageContents Batch update messages in a conversation ad · LinkedIn Batch Update Sponsored Message Content #

Ask an LLM

“Can I update many conversation ad messages in one request?”

“Is there a bulk edit for sponsored message content?”

Tell an agent

Batch update messages {ids} in conversation {conversationUrn}.

Apply bulk edits to the message set of {conversationUrn}.

DELETE /conversationAds/{conversationUrn}/sponsoredMessageContents Batch delete messages from a conversation ad · LinkedIn Batch Delete Sponsored Message Content #

Ask an LLM

“Can I remove several messages from a conversation ad at once?”

“What happens if I bulk delete sponsored message content?”

Tell an agent destructive · confirm first

Delete messages {ids} from conversation {conversationUrn}.

Batch remove message content from conversation ad {conversationUrn}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/linkedin:linkedin-use-cases-conversation-ad-sponsored-message-contents-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Use Cases > Conversation Ad > Sponsored Message Contents API
  description: Please note that these are versioned set of APIs and they are different than the earlier one.
  version: 1.0.0
servers:
- url: https://api.linkedin.com
  description: LinkedIn Marketing API Production Server
security:
- oauth2Auth: []
tags:
- name: Use Cases > Conversation Ad > Sponsored Message Contents
  description: Within our API, Conversation Ads are represented by the Sponsored Conversation entity. Sponsored Conversations are composed of Sponsored Message Content.
paths:
  /conversationAds/{conversationAdsId}/sponsoredMessageContents:
    post:
      tags:
      - Use Cases > Conversation Ad > Sponsored Message Contents
      summary: LinkedIn Batch Create Sponsored Message Content
      description: Creates Sponsored Message Content in Batches.
      requestBody:
        content:
          '*/*':
            schema:
              $ref: '#/components/schemas/BatchCreateSponsoredMessageRequest'
      parameters:
      - name: LinkedIn-Version
        in: header
        schema:
          type: string
        example: '{{insert_version}}'
      - name: Authorization
        in: header
        schema:
          type: string
        example: '{{insert_token}}'
      - name: X-RestLi-Method
        in: header
        schema:
          type: string
        example: BATCH_CREATE
      - name: conversationAdsId
        in: path
        schema:
          type: string
        required: true
        example: '123456'
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
      operationId: postBatchCreateSponsoredMessage
      x-microcks-operation:
        dispatcher: FALLBACK
        dispatcherRules: '{}'
        delay: 0
  /conversationAds/{conversationUrn}/sponsoredMessageContents/{messageUrn}:
    get:
      tags:
      - Use Cases > Conversation Ad > Sponsored Message Contents
      summary: LinkedIn Get Sponsored Message Content
      description: Retrieves just a single message content from all the conversations in a conversation Ad.
      parameters:
      - name: LinkedIn-Version
        in: header
        schema:
          type: string
        example: '{{insert_version}}'
      - name: Authorization
        in: header
        schema:
          type: string
        example: '{{insert_token}}'
      - name: conversationUrn
        in: path
        schema:
          type: string
        required: true
        example: urn:li:organization:123456
      - name: messageUrn
        in: path
        schema:
          type: string
        required: true
        example: urn:li:organization:123456
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
      operationId: getGetSponsoredMessageContent
      x-microcks-operation:
        dispatcher: FALLBACK
        dispatcherRules: '{}'
        delay: 0
    post:
      tags:
      - Use Cases > Conversation Ad > Sponsored Message Contents
      summary: LinkedIn Update Sponsored Message Content
      description: Updates the message contents from all the conversations in a conversation Ad.
      requestBody:
        content:
          '*/*':
            schema:
              $ref: '#/components/schemas/UpdateSponsoredMessageContentRequest'
      parameters:
      - name: LinkedIn-Version
        in: header
        schema:
          type: string
        example: '{{insert_version}}'
      - name: Authorization
        in: header
        schema:
          type: string
        example: '{{insert_token}}'
      - name: conversationUrn
        in: path
        schema:
          type: string
        required: true
        example: urn:li:organization:123456
      - name: messageUrn
        in: path
        schema:
          type: string
        required: true
        example: urn:li:organization:123456
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
      operationId: postUpdateSponsoredMessageContent
      x-microcks-operation:
        dispatcher: FALLBACK
        dispatcherRules: '{}'
        delay: 0
  /conversationAds/{conversationUrn}/sponsoredMessageContents:
    get:
      tags:
      - Use Cases > Conversation Ad > Sponsored Message Contents
      summary: LinkedIn Batch Get Sponsored Message Content
      description: Retrieves Sponsored Message Content in Batches.
      parameters:
      - name: LinkedIn-Version
        in: header
        schema:
          type: string
        example: '{{insert_version}}'
      - name: Authorization
        in: header
        schema:
          type: string
        example: '{{insert_token}}'
      - name: X-RestLi-Method
        in: header
        schema:
          type: string
        example: BATCH_GET
      - name: ids
        in: query
        schema:
          type: string
        example: List({message-urn1},{message-urn2})
      - name: conversationUrn
        in: path
        schema:
          type: string
        required: true
        example: urn:li:organization:123456
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
      operationId: getBatchGetSponsoredMessage
      x-microcks-operation:
        dispatcher: FALLBACK
        dispatcherRules: '{}'
        delay: 0
    post:
      tags:
      - Use Cases > Conversation Ad > Sponsored Message Contents
      summary: LinkedIn Batch Update Sponsored Message Content
      description: Updates Sponsored Message Content in Batches.
      requestBody:
        content:
          '*/*':
            schema:
              $ref: '#/components/schemas/BatchUpdateSponsoredMessageRequest'
      parameters:
      - name: '''Authorization'
        in: header
        schema:
          type: string
        example: '{{insert_token}}'
      - name: LinkedIn-Version
        in: header
        schema:
          type: string
        example: '{{insert_version}}'
      - name: X-RestLi-Method
        in: header
        schema:
          type: string
        example: BATCH_UPDATE
      - name: ids
        in: query
        schema:
          type: string
        example: List({message-urn1},{message-urn2})
      - name: conversationUrn
        in: path
        schema:
          type: string
        required: true
        example: urn:li:organization:123456
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
      operationId: postBatchUpdateSponsoredMessage
      x-microcks-operation:
        dispatcher: FALLBACK
        dispatcherRules: '{}'
        delay: 0
    delete:
      tags:
      - Use Cases > Conversation Ad > Sponsored Message Contents
      summary: LinkedIn Batch Delete Sponsored Message Content
      description: Deletes Sponsored Message Content in Batches.
      parameters:
      - name: Authorization
        in: header
        schema:
          type: string
        example: '{{insert_token}}'
      - name: LinkedIn-Version
        in: header
        schema:
          type: string
        example: '{{insert_version}}'
      - name: X-RestLi-Method
        in: header
        schema:
          type: string
        example: BATCH_DELETE
      - name: ids
        in: query
        schema:
          type: string
        example: List({message-urn1},{message-urn2})'
      - name: conversationUrn
        in: path
        schema:
          type: string
        required: true
        example: urn:li:organization:123456
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
      operationId: deleteBatchDeleteSponsoredMessage
      x-microcks-operation:
        dispatcher: FALLBACK
        dispatcherRules: '{}'
        delay: 0
components:
  schemas:
    UpdateSponsoredMessageContentRequest:
      type: string
      example: '"{\n  \"patch\": {\n    \"$set\": {\n      \"bodySource\": {\n         “text”: “New updated text”\n      }\n    }\n  }\n}\n"'
    BatchUpdateSponsoredMessageRequest:
      type: string
      example: '"{\n       \"entities\": {\n        \"urn:li:sponsoredMessageContent:(urn_sponsoredConversation:sp1,sp2)\": {\n              \"patch\": {\n                  \"$set\": {\n                      \"bodySource\": {\n                         “text”: “New updated text”\n                      }\n                   }\n                }\n    },\n         \"urn:li:sponsoredMessageContent:(urn_sponsoredConversation:sp1,sp2)\": {\n              \"patch\": {\n                  \"$set\": {\n                      \"bodySource\": {\n                         “text”: “New updated text2”\n                      }\n                   }\n                }\n    }\n    }\n}\n\n"'
    BatchCreateSponsoredMessageRequest:
      type: string
      example: '"{\n    \"elements\": [ {\n              \"bodySource\": {\n         \"leadGenerationForm\": \"urn:li:adForm:434835\"\n       },\n               \"nextAction\":{\n                  \"options\":[\n                    {\n                        \"replyType\": \"LEAD_GENERATION_THANK_YOU\",\n                        \"optionText\": \"Visit website\"\n                    },\n                    {\n                        \"replyType\": \"SIMPLE_REPLY\",\n                                                \"nextContent\": \"urn:li:sponsoredMessageContent:(urn:li:sponsoredConversation:186604,14253)\",\n                        \"optionText\": \"Simple reply\"\n                    },\n                    {\n                        \"replyType\": \"EXTERNAL_WEBSITE\",\n                        \"optionText\": \"Visit website\",\n                        \"landingPage\": \"http://www.linkedin.com\"\n                    }\n                  ]\n               }\n        },{\n            \"bodySource\": {\n        \"text\": \"Sample text\"\n      },\n             \"nextAction\":{\n                  \"options\":[\n                    {\n                        \"replyType\": \"EXTERNAL_WEBSITE\",\n                        \"optionText\": \"Other website\",\n                        \"landingPage\": \"http://www.microsoft.com\"\n                    }\n                  ]\n               }\n\n        }]\n}\n\n"'
  securitySchemes:
    oauth2Auth:
      type: http
      scheme: oauth2

LinkedIn Use Cases > Conversation Ad > Sponsored Message Contents API

Operations 6

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification