Live Direct Marketing

Live Direct Marketing Contact Lists API

The Contact Lists API from Live Direct Marketing — 8 operation(s) for contact lists.

GitHub OpenAPI

Operations 11

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 /api/contact-lists List contact lists · List all contact lists for the tenant #
Ask an LLM
“What contact lists do I have?”
“Can I see all the contact lists in my workspace?”
Tell an agent
List all my contact lists.
Show every contact list in this tenant.
POST /api/contact-lists Create a contact list · Create a new contact list #
Ask an LLM
“How do I create a new contact list?”
“Can I make a smart list that fills itself from filters?”
Tell an agent
Create a contact list named {name}.
Make a smart contact list {name} using filters {filters}.
PATCH /api/contact-lists/{id} Update a contact list · Update a contact list #
Ask an LLM
“Can I rename a contact list or pin it to the top?”
“Is it possible to move a contact list into a different group?”
Tell an agent
Rename contact list {id} to {name}.
Move list {id} into group {group}.
DELETE /api/contact-lists/{id} Delete a contact list · Delete a contact list #
Ask an LLM
“Can I delete a contact list I no longer need?”
“What happens when I remove a whole contact list?”
Tell an agent destructive · confirm first
Delete contact list {id}.
Remove list {id} entirely.
POST /api/contact-lists/reorder Reorder contact lists · Reorder contact lists by id/sortOrder array #
Ask an LLM
“Can I change the order my contact lists appear in?”
“How do I set a custom sort order for lists?”
Tell an agent
Reorder my contact lists as {items}.
Apply this sort order to my contact lists: {items}.
POST /api/contact-lists/{id}/contacts Add contacts to a list · Add contacts to a list #
Ask an LLM
“How do I put contacts into an existing list?”
“Can I add several contacts to a list at once?”
Tell an agent
Add contacts {contacts} to list {id}.
Put {contacts} into contact list {id}.
DELETE /api/contact-lists/{id}/contacts Remove contacts from a list · Remove contacts from a list #
Ask an LLM
“Can I take contacts out of a list without deleting them?”
“Does removing someone from a list delete the contact itself?”
Tell an agent destructive · confirm first
Remove contacts from list {id}.
Take the selected contacts out of list {id}.
POST /api/contact-lists/{id}/duplicate Duplicate a contact list · Duplicate a contact list #
Ask an LLM
“Can I copy a contact list to start a new one?”
“Is there a quick way to clone a list?”
Tell an agent
Duplicate contact list {id}.
Make a copy of list {id}.
GET /api/contact-lists/all-statistics Get statistics for all contact lists · Get statistics across all contact lists #
Ask an LLM
“How big is each of my contact lists?”
“Can I see statistics for every list in one view?”
Tell an agent
Show statistics across all my contact lists.
Summarize the size and stats of every list.
GET /api/contact-lists/compare Compare two contact lists · Compare statistics between two contact lists #
Ask an LLM
“How do two of my contact lists differ in their statistics?”
“Can I put two lists side by side?”
Tell an agent
Compare contact list {a} with list {b}.
Show stats for lists {a} and {b} side by side.
GET /api/contact-lists/{id}/statistics Get statistics for one contact list · Get statistics for a single contact list #
Ask an LLM
“What's in a single contact list, by the numbers?”
“Where can I see one list's statistics?”
Tell an agent
Show statistics for contact list {id}.
Get the numbers for list {id}.

Documentation

📖
Documentation
https://developers.live-direct-marketing.online/
📖
APIReference
https://developers.live-direct-marketing.online/api-reference
📖
GettingStarted
https://developers.live-direct-marketing.online/quickstart
📖
Authentication
https://developers.live-direct-marketing.online/authentication
📖
Documentation
https://check.live-direct-marketing.online/docs
📖
APIReference
https://check.live-direct-marketing.online/api/docs

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/live-direct-marketing-online/refs/heads/main/openapi/live-direct-marketing-online-contact-lists-api-openapi.yml

Other Resources

🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/live-direct-marketing-online/refs/heads/main/data-model/live-direct-marketing-online-data-model.yml

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/live-direct-marketing-online:live-direct-marketing-online-contact-lists-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

live-direct-marketing-online-contact-lists-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: LDM v3 Contact Lists API
  description: 'Multi-tenant B2B outreach automation platform. Auth: JWT Bearer (15-min) or tenant API key (ldm_*) managed in CRM Settings → API Keys. All tenant-scoped endpoints require the X-Tenant-Id header.'
  version: 1.0.0
  contact: {}
servers:
- url: https://api.live-direct-marketing.online
  description: Production
- url: https://api.dev.live-direct-marketing.online
  description: Development
- url: http://127.0.0.1:3000
  description: Local
tags:
- name: Contact Lists
paths:
  /api/contact-lists:
    get:
      operationId: ContactListsController_findAll
      parameters:
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      responses:
        '200':
          description: ''
      security:
      - jwt: []
      summary: List all contact lists for the tenant
      tags:
      - Contact Lists
    post:
      operationId: ContactListsController_create
      parameters:
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContactListsCreateDto'
      responses:
        '201':
          description: ''
      security:
      - jwt: []
      summary: Create a new contact list
      tags:
      - Contact Lists
  /api/contact-lists/{id}:
    patch:
      operationId: ContactListsController_update
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContactListsUpdateDto'
      responses:
        '200':
          description: ''
      security:
      - jwt: []
      summary: Update a contact list
      tags:
      - Contact Lists
    delete:
      operationId: ContactListsController_remove
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      responses:
        '200':
          description: ''
      security:
      - jwt: []
      summary: Delete a contact list
      tags:
      - Contact Lists
  /api/contact-lists/reorder:
    post:
      operationId: ContactListsController_reorder
      parameters:
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContactListsReorderDto'
      responses:
        '201':
          description: ''
      security:
      - jwt: []
      summary: Reorder contact lists by id/sortOrder array
      tags:
      - Contact Lists
      x-required-scope:
      - crm:write
  /api/contact-lists/{id}/contacts:
    post:
      operationId: ContactListsController_addContacts
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContactListsAddContactsDto'
      responses:
        '201':
          description: ''
      security:
      - jwt: []
      summary: Add contacts to a list
      tags:
      - Contact Lists
    delete:
      operationId: ContactListsController_removeContacts
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      responses:
        '200':
          description: ''
      security:
      - jwt: []
      summary: Remove contacts from a list
      tags:
      - Contact Lists
  /api/contact-lists/{id}/duplicate:
    post:
      operationId: ContactListsController_duplicate
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      responses:
        '201':
          description: ''
      security:
      - jwt: []
      summary: Duplicate a contact list
      tags:
      - Contact Lists
  /api/contact-lists/all-statistics:
    get:
      operationId: ContactListsController_allStatistics
      parameters:
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      responses:
        '200':
          description: ''
      security:
      - jwt: []
      summary: Get statistics across all contact lists
      tags:
      - Contact Lists
      x-required-scope:
      - crm:read
  /api/contact-lists/compare:
    get:
      operationId: ContactListsController_compare
      parameters:
      - name: a
        required: true
        in: query
        schema:
          type: string
      - name: b
        required: true
        in: query
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      responses:
        '200':
          description: ''
      security:
      - jwt: []
      summary: Compare statistics between two contact lists
      tags:
      - Contact Lists
      x-required-scope:
      - crm:read
  /api/contact-lists/{id}/statistics:
    get:
      operationId: ContactListsController_statistics
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      responses:
        '200':
          description: ''
      security:
      - jwt: []
      summary: Get statistics for a single contact list
      tags:
      - Contact Lists
components:
  schemas:
    ContactListsReorderItemDto:
      type: object
      properties:
        id:
          type: string
        sortOrder:
          type: number
      required:
      - id
      - sortOrder
    ContactListsUpdateDto:
      type: object
      properties:
        name:
          type: string
        description:
          type: string
        color:
          type: string
        icon:
          type: string
        type:
          type: string
        smartFilters:
          type: object
        viewConfig:
          type: object
        isPinned:
          type: boolean
        groupId:
          type:
          - object
          - 'null'
    ContactListsReorderDto:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/ContactListsReorderItemDto'
      required:
      - items
    ContactListsAddContactsDto:
      type: object
      properties:
        contactIds:
          type: array
          items:
            type: string
      required:
      - contactIds
    ContactListsCreateDto:
      type: object
      properties:
        name:
          type: string
        description:
          type: string
        color:
          type: string
        icon:
          type: string
        type:
          type: string
        smartFilters:
          type: object
        isPinned:
          type: boolean
        groupId:
          type:
          - object
          - 'null'
      required:
      - name
  securitySchemes:
    jwt:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: JWT access token from /auth/login (Bearer <token>)
    tenant-api-key:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: Tenant API key (Bearer ldm_*) for MCP/A2A clients. Issued via CRM Settings → API Keys.
    rpa-service:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: Dedicated RPA service key. No tenant API-key or query-key authentication.