LinkedIn

LinkedIn DMP Segments API

APIs to create and manage DMP segments for audience targeting

GitHub OpenAPI
Business capability
Digital Marketing Management BC-400.60

Operations 2

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

GET /dmpSegments Monitor DMP segments for an ad account · LinkedIn Monitor DMP Segment Status #
Ask an LLM
“What's the match rate and audience size of my uploaded segments?”
“Can I filter matched audience segments by source platform?”
Tell an agent
Show DMP segments for ad account {account}.
List segments in {account} from source {sourcePlatform}.
POST /dmpSegments Create a DMP segment · LinkedIn Create DMP Segment #
Ask an LLM
“Can I create a matched audience segment for list uploads or streaming?”
“How long must I wait after creating a segment before adding data?”
Tell an agent
Create a {type} segment named {name} in account {account}.
Create segment {name} from {sourcePlatform} with policy {accessPolicy} and destinations {destinations}.

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/linkedin/marketing/
📖
GettingStarted
https://learn.microsoft.com/en-us/linkedin/marketing/getting-started
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/learning/
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/learning/getting-started/terminology
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/learning/integrations/xapi
📖
APIReference
https://learn.microsoft.com/en-us/linkedin/learning/reporting/reporting-docs/reporting-api
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/talent/
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/talent/versioning
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/compliance/
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/compliance/compliance-api/overview
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/sales/
📖
APIReference
https://learn.microsoft.com/en-us/linkedin/sales/display-services/
📖
APIReference
https://learn.microsoft.com/en-us/linkedin/sales/analytics-services/
📖
APIReference
https://learn.microsoft.com/en-us/linkedin/sales/sync-services/
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/dma/
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/dma/member-data-portability/
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/dma/pages-data-portability-overview
📖
Documentation
https://learn.microsoft.com/en-us/linkedin/dma/transparency/advertiser-transparency

Specifications

⚙
OpenAPI
https://artifacts.apis.io/linkedin/openapi/linkedin-dmp-segments-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/linkedin/json-schema/linkedin-dmp-segment-schema.json
📊
JSONSchema
https://artifacts.apis.io/linkedin/json-schema/linkedin-dmp-segment-create-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/linkedin/json-schema/linkedin-dmp-segments-response-schema.json

Other Resources

🔗
UseCases
https://learn.microsoft.com/en-us/linkedin/marketing/usecases/
🔗
ChangeLog
https://learn.microsoft.com/en-us/linkedin/marketing/integrations/recent-changes
🔗
FAQ
https://learn.microsoft.com/en-us/linkedin/marketing/lms-faq
🔗
PostmanWorkspace
https://www.postman.com/linkedin-developer-apis/workspace/linkedin-marketing-solutions-versioned-apis/overview
🔗
ReleaseNotes
https://learn.microsoft.com/en-us/linkedin/learning/integrations/release-notes
🔗
PostmanWorkspace
https://www.postman.com/linkedin-developer-apis/workspace/linkedin-learning-solutions/overview
🔗
ReleaseNotes
https://learn.microsoft.com/en-us/linkedin/talent/release-notes
🔗
PostmanWorkspace
https://www.postman.com/linkedin-developer-apis/workspace/linkedin-talent-solutions/overview
🔗
ReleaseNotes
https://learn.microsoft.com/en-us/linkedin/compliance/release-notes
🔗
FAQ
https://learn.microsoft.com/en-us/linkedin/compliance/compliance-api/compliance-faq
🔗
PostmanWorkspace
https://www.postman.com/linkedin-developer-apis/workspace/linkedin-compliance-solutions/overview
🔗
FAQ
https://learn.microsoft.com/en-us/linkedin/dma/transparency/advertiser-transparency-faq
🔗
ChangeLog
https://learn.microsoft.com/en-us/linkedin/dma/recent-changes

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-dmp-segments-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

linkedin-dmp-segments-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: LinkedIn Marketing Audiences DMP Segments API
  description: LinkedIn Audiences API enables combining LinkedIn's data with your own data to reach the right audiences on LinkedIn. This includes streaming companies for account targeting, streaming users for contact targeting, and CSV list uploads for both account and contact targeting.
  version: 1.0.0
  contact:
    name: LinkedIn Marketing API Support
    url: https://docs.microsoft.com/en-us/linkedin/marketing/
servers:
- url: https://api.linkedin.com/rest
  description: LinkedIn REST API Server
security:
- OAuth2Auth:
  - rw_ads
tags:
- name: DMP Segments
  description: APIs to create and manage DMP segments for audience targeting
paths:
  /dmpSegments:
    get:
      tags:
      - DMP Segments
      summary: LinkedIn Monitor DMP Segment Status
      description: Retrieve DMP segments for a specific ad account. Monitor status, match rate, and audience size.
      operationId: getDmpSegments
      x-microcks-operation:
        dispatcher: FALLBACK
        dispatcherRules: ''
      parameters:
      - name: X-Restli-Protocol-Version
        in: header
        required: true
        schema:
          type: string
        example: 2.0.0
      - name: LinkedIn-Version
        in: header
        required: true
        schema:
          type: string
        example: '202401'
      - name: q
        in: query
        required: true
        schema:
          type: string
          enum:
          - account
        description: Query type
        example: account
      - name: account
        in: query
        required: true
        schema:
          type: string
        description: Sponsored account URN (URL encoded)
        example: urn%3Ali%3AsponsoredAccount%3A123456
      - name: sourcePlatform
        in: query
        required: false
        schema:
          type: string
          enum:
          - LIST_UPLOAD
          - STREAMING
        description: Filter by source platform
        example: LIST_UPLOAD
      responses:
        '200':
          description: Successfully retrieved DMP segments
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DmpSegmentsResponse'
              examples:
                SuccessResponse:
                  value:
                    paging:
                      start: 0
                      count: 10
                      total: 1
                      links: []
                    elements:
                    - id: 987654321
                      name: DMP segment for CSV uploads
                      account: urn:li:sponsoredAccount:123456
                      accessPolicy: PRIVATE
                      type: COMPANY_LIST_UPLOAD
                      sourcePlatform: LIST_UPLOAD
                      status: READY
                      matchedCount: 5000
                      inputCount: 6000
                      audienceSize: 4500
                      destinations:
                      - destination: LINKEDIN
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    post:
      tags:
      - DMP Segments
      summary: LinkedIn Create DMP Segment
      description: 'Create a new DMP segment for list upload or streaming. Note: There must be at least a 5 second delay between creating the segment and attaching data.'
      operationId: createDmpSegment
      x-microcks-operation:
        dispatcher: FALLBACK
        dispatcherRules: ''
      parameters:
      - name: X-Restli-Protocol-Version
        in: header
        required: true
        schema:
          type: string
        example: 2.0.0
      - name: LinkedIn-Version
        in: header
        required: true
        schema:
          type: string
        example: '202401'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DmpSegmentCreateRequest'
            examples:
              CreateSegment:
                $ref: '#/components/examples/DmpSegmentCreateRequestExample'
      responses:
        '201':
          description: DMP segment created successfully
          headers:
            X-RestLi-Id:
              description: ID of the created segment
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DmpSegment'
              examples:
                SuccessResponse:
                  value:
                    id: 987654321
                    name: DMP segment for CSV uploads
                    account: urn:li:sponsoredAccount:123456
                    accessPolicy: PRIVATE
                    type: COMPANY_LIST_UPLOAD
                    sourcePlatform: LIST_UPLOAD
                    status: PROCESSING
                    destinations:
                    - destination: LINKEDIN
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        status:
          type: integer
          description: HTTP status code
          example: 400
        message:
          type: string
          description: Error message
          example: Invalid request parameters
        code:
          type: string
          description: Error code
          example: INVALID_PARAMS
    DmpSegmentsResponse:
      type: object
      properties:
        elements:
          type: array
          items:
            $ref: '#/components/schemas/DmpSegment'
        paging:
          $ref: '#/components/schemas/Paging'
    DmpSegmentCreateRequest:
      type: object
      properties:
        accessPolicy:
          type: string
          enum:
          - PRIVATE
          - PUBLIC
          description: Access policy for the segment
          example: PRIVATE
        account:
          type: string
          description: URN of the sponsored account
          example: urn:li:sponsoredAccount:123456
        destinations:
          type: array
          items:
            $ref: '#/components/schemas/SegmentDestination'
        name:
          type: string
          description: Display name for the segment
          example: DMP segment for CSV uploads
        sourcePlatform:
          type: string
          enum:
          - LIST_UPLOAD
          - STREAMING
          description: Source platform
          example: LIST_UPLOAD
        type:
          type: string
          enum:
          - COMPANY_LIST_UPLOAD
          - USER_LIST_UPLOAD
          - COMPANY_STREAMING
          - USER_STREAMING
          description: Type of segment
          example: COMPANY_LIST_UPLOAD
      required:
      - accessPolicy
      - account
      - destinations
      - name
      - sourcePlatform
      - type
    DmpSegment:
      type: object
      properties:
        id:
          type: integer
          format: int64
          description: Unique identifier for the DMP segment
          example: 987654321
        name:
          type: string
          description: Display name of the segment
          example: DMP segment for CSV uploads
        account:
          type: string
          description: URN of the sponsore account
          example: urn:li:sponsoredAccount:123456
        accessPolicy:
          type: string
          enum:
          - PRIVATE
          - PUBLIC
          description: Access policy for the segment
          example: PRIVATE
        type:
          type: string
          enum:
          - COMPANY_LIST_UPLOAD
          - USER_LIST_UPLOAD
          - COMPANY_STREAMING
          - USER_STREAMING
          description: Type of DMP segment
          example: COMPANY_LIST_UPLOAD
        sourcePlatform:
          type: string
          enum:
          - LIST_UPLOAD
          - STREAMING
          description: Source platform for the segment data
          example: LIST_UPLOAD
        status:
          type: string
          enum:
          - PROCESSING
          - READY
          - EXPIRED
          - FAILED
          description: Current status of the segment
          example: READY
        matchedCount:
          type: integer
          description: Number of matched records
          example: 5000
        inputCount:
          type: integer
          description: Total number of input records
          example: 6000
        audienceSize:
          type: integer
          description: Size of the audience
          example: 4500
        destinations:
          type: array
          items:
            $ref: '#/components/schemas/SegmentDestination'
      required:
      - name
      - account
      - type
      - sourcePlatform
    SegmentDestination:
      type: object
      properties:
        destination:
          type: string
          enum:
          - LINKEDIN
          description: Destination platform
          example: LINKEDIN
    Paging:
      type: object
      properties:
        start:
          type: integer
          description: Starting index
          example: 0
        count:
          type: integer
          description: Number of results returned
          example: 10
        total:
          type: integer
          description: Total number of results
          example: 2
        links:
          type: array
          items:
            type: string
  examples:
    DmpSegmentCreateRequestExample:
      summary: Create list upload DMP segment
      value:
        accessPolicy: PRIVATE
        account: urn:li:sponsoredAccount:123456
        destinations:
        - destination: LINKEDIN
        name: DMP segment for CSV uploads
        sourcePlatform: LIST_UPLOAD
        type: COMPANY_LIST_UPLOAD
  securitySchemes:
    OAuth2Auth:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://www.linkedin.com/oauth/v2/authorization
          tokenUrl: https://www.linkedin.com/oauth/v2/accessToken
          scopes:
            rw_ads: Read and write advertising data