Live Direct Marketing

Live Direct Marketing Custom Events API

The Custom Events API from Live Direct Marketing — 3 operation(s) for custom events.

GitHub OpenAPI

Operations 4

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 /api/custom-events Track a single custom event · Track a single custom event #
Ask an LLM
“How do I record that a lead attended a webinar as a custom event?”
“Can I log one product-usage event against a contact?”
Tell an agent
Track one custom event for this contact.
Record a single custom event that a lead booked a demo.
GET /api/custom-events List tracked custom events · List custom events with filters and pagination #
Ask an LLM
“Which custom events were recorded for a particular contact?”
“Can I filter custom events by name, source and date range?”
Tell an agent
List custom events named {eventName} between {dateFrom} and {dateTo}.
Show custom events for {entityType} {entityId}.
POST /api/custom-events/bulk Track custom events in bulk · Track up to 500 custom events in one request #
Ask an LLM
“What is the maximum number of custom events I can send in one batch?”
“Can I import many custom events at once instead of one by one?”
Tell an agent
Bulk-track this batch of up to 500 custom events.
Send all these custom events in a single bulk request.
GET /api/custom-events/aggregates Count custom events over a date range · Get aggregated custom event counts by date range #
Ask an LLM
“How many custom events of each type happened last month?”
“What are the totals per custom event between two dates?”
Tell an agent
Give me aggregated custom event counts from {dateFrom} to {dateTo}.
Summarize custom event totals by name for {dateFrom} through {dateTo}.

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-custom-events-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-custom-events-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-custom-events-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: LDM v3 Custom Events 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: Custom Events
paths:
  /api/custom-events:
    post:
      operationId: CustomEventsController_track
      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: Track a single custom event
      tags:
      - Custom Events
    get:
      operationId: CustomEventsController_list
      parameters:
      - name: eventName
        required: true
        in: query
        schema:
          type: string
      - name: entityType
        required: true
        in: query
        schema:
          type: string
      - name: entityId
        required: true
        in: query
        schema:
          type: string
      - name: source
        required: true
        in: query
        schema:
          type: string
      - name: dateFrom
        required: true
        in: query
        schema:
          type: string
      - name: dateTo
        required: true
        in: query
        schema:
          type: string
      - name: page
        required: true
        in: query
        schema:
          type: string
      - name: pageSize
        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: List custom events with filters and pagination
      tags:
      - Custom Events
  /api/custom-events/bulk:
    post:
      operationId: CustomEventsController_bulkTrack
      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: Track up to 500 custom events in one request
      tags:
      - Custom Events
      x-required-scope:
      - events:write
  /api/custom-events/aggregates:
    get:
      operationId: CustomEventsController_aggregates
      parameters:
      - name: dateFrom
        required: true
        in: query
        schema:
          type: string
      - name: dateTo
        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: Get aggregated custom event counts by date range
      tags:
      - Custom Events
      x-required-scope:
      - events:read
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.