Live Direct Marketing

Live Direct Marketing Contact List Groups API

The Contact List Groups API from Live Direct Marketing — 3 operation(s) for contact list groups.

GitHub OpenAPI

Operations 5

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-list-groups List contact list groups · List contact list groups (flat, with parentId for tree) #
Ask an LLM
“How are my contact lists organized into groups?”
“Can I get the contact list group tree with parent ids?”
Tell an agent
List my contact list groups.
Show the contact list group tree.
POST /api/contact-list-groups Create a contact list group · Create a contact list group #
Ask an LLM
“How do I make a folder to organize my contact lists?”
“Can I nest a new contact list group under another one?”
Tell an agent
Create a contact list group.
Add a new group for organizing contact lists.
POST /api/contact-list-groups/reorder Reorder contact list groups · Reorder contact list groups by id/sortOrder array #
Ask an LLM
“Can I change the order my contact list groups appear in?”
“How do I set a custom sort order for list groups?”
Tell an agent
Reorder my contact list groups.
Apply a new sort order to my contact list groups.
PATCH /api/contact-list-groups/{id} Update a contact list group · Update a contact list group (name/description/color/parent/sort) #
Ask an LLM
“Can I rename a contact list group or change its color?”
“How do I move a contact list group under a different parent?”
Tell an agent
Update contact list group {id}.
Rename contact list group {id} and change its color.
DELETE /api/contact-list-groups/{id} Delete a contact list group · Delete a contact list group (children + lists are detached) #
Ask an LLM
“What happens to the lists inside a group when I delete the group?”
“Can I delete a contact list group without deleting its lists?”
Tell an agent destructive · confirm first
Delete contact list group {id}.
Remove list group {id} and detach its lists.

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-list-groups-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-list-groups-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-list-groups-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: LDM v3 Contact List Groups 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 List Groups
paths:
  /api/contact-list-groups:
    get:
      operationId: ContactListGroupsController_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 contact list groups (flat, with parentId for tree)
      tags:
      - Contact List Groups
    post:
      operationId: ContactListGroupsController_create
      parameters:
      - 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: Create a contact list group
      tags:
      - Contact List Groups
  /api/contact-list-groups/reorder:
    post:
      operationId: ContactListGroupsController_reorder
      parameters:
      - 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: Reorder contact list groups by id/sortOrder array
      tags:
      - Contact List Groups
      x-required-scope:
      - crm:write
  /api/contact-list-groups/{id}:
    patch:
      operationId: ContactListGroupsController_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
      responses:
        '200':
          description: ''
      security:
      - jwt: []
      summary: Update a contact list group (name/description/color/parent/sort)
      tags:
      - Contact List Groups
    delete:
      operationId: ContactListGroupsController_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 group (children + lists are detached)
      tags:
      - Contact List Groups
components:
  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.