Live Direct Marketing

Live Direct Marketing Notifications API

The Notifications API from Live Direct Marketing — 10 operation(s) for notifications.

GitHub OpenAPI

Operations 10

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/notifications/push/public-key Get the Web Push VAPID public key · Get the tenant VAPID public key for Web Push #
Ask an LLM
“What VAPID public key do I need to subscribe a browser to push notifications?”
“Where do I get the key for setting up Web Push?”
Tell an agent
Get the tenant VAPID public key for Web Push.
Fetch the push notification public key.
POST /api/notifications/push/subscribe Register a browser for push notifications · Register a browser Web Push subscription #
Ask an LLM
“How do I turn on browser push notifications for my account?”
“Can I register a Web Push subscription with an expiration time?”
Tell an agent
Register push subscription endpoint {endpoint} with keys {keys}.
Subscribe browser {user-agent} to push at {endpoint} using keys {keys}.
POST /api/notifications/push/unsubscribe Remove a browser push subscription · Remove a browser Web Push subscription #
Ask an LLM
“How do I stop push notifications in a browser?”
“Can I unregister one Web Push subscription?”
Tell an agent destructive · confirm first
Unsubscribe push endpoint {endpoint}.
Remove the Web Push subscription at {endpoint}.
GET /api/notifications List my notifications · List notifications for the current user #
Ask an LLM
“What notifications do I have?”
“Can I filter notifications by type or include dismissed ones?”
Tell an agent
List my notifications of type {type}.
Show page {page} of notifications with dismissed={dismissed}, {pageSize} per page.
GET /api/notifications/unread-count Get my unread notification count · Get the unread notifications badge count #
Ask an LLM
“How many unread notifications do I have?”
“What number should the notification badge show?”
Tell an agent
Get my unread notification count.
Tell me how many notifications are unread.
POST /api/notifications/read-all Mark all notifications as read · Mark all unread notifications as read #
Ask an LLM
“Can I clear every unread notification at once?”
“How do I mark everything in my notifications as read?”
Tell an agent
Mark all my notifications as read.
Clear my unread notification badge.
POST /api/notifications/{id}/read Mark one notification as read · Mark a notification as read #
Ask an LLM
“How do I mark a single notification as read?”
“Can I acknowledge just one notification?”
Tell an agent
Mark notification {id} as read.
Set notification {id} to read.
POST /api/notifications/{id}/dismiss Dismiss one notification · Dismiss a notification (hide from widget) #
Ask an LLM
“Can I hide one notification from the widget?”
“How do I dismiss a specific notification?”
Tell an agent
Dismiss notification {id}.
Hide notification {id} from my widget.
POST /api/notifications/dismiss-all Dismiss all my notifications · Dismiss all notifications for the current user #
Ask an LLM
“How do I hide every notification from the widget in one go?”
“Can I dismiss all my notifications at once?”
Tell an agent
Dismiss all my notifications.
Hide every notification from my widget.
POST /api/notifications/self-note Leave myself a note as a notification · Create an agent self-note notification #
Ask an LLM
“Can an agent post a reminder note into my notifications?”
“How do I create a self-note that shows up as a notification?”
Tell an agent
Create a self-note titled {title} saying {message}.
Remind me with a notification {title}: {message}.

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-notifications-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-notifications-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-notifications-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: LDM v3 Notifications 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: Notifications
paths:
  /api/notifications/push/public-key:
    get:
      operationId: NotificationsController_pushPublicKey
      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 the tenant VAPID public key for Web Push
      tags:
      - Notifications
      x-required-scope:
      - notifications:read
  /api/notifications/push/subscribe:
    post:
      operationId: NotificationsController_pushSubscribe
      parameters:
      - name: user-agent
        required: true
        in: header
        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/PushSubscribeDto'
      responses:
        '201':
          description: ''
      security:
      - jwt: []
      summary: Register a browser Web Push subscription
      tags:
      - Notifications
      x-required-scope:
      - notifications:write
  /api/notifications/push/unsubscribe:
    post:
      operationId: NotificationsController_pushUnsubscribe
      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/PushUnsubscribeDto'
      responses:
        '201':
          description: ''
      security:
      - jwt: []
      summary: Remove a browser Web Push subscription
      tags:
      - Notifications
      x-required-scope:
      - notifications:write
  /api/notifications:
    get:
      operationId: NotificationsController_findAll
      parameters:
      - name: dismissed
        required: true
        in: query
        schema:
          type: string
      - name: type
        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 notifications for the current user
      tags:
      - Notifications
  /api/notifications/unread-count:
    get:
      operationId: NotificationsController_unreadCount
      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 the unread notifications badge count
      tags:
      - Notifications
      x-required-scope:
      - notifications:read
  /api/notifications/read-all:
    post:
      operationId: NotificationsController_readAll
      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: Mark all unread notifications as read
      tags:
      - Notifications
      x-required-scope:
      - notifications:write
  /api/notifications/{id}/read:
    post:
      operationId: NotificationsController_markRead
      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: Mark a notification as read
      tags:
      - Notifications
  /api/notifications/{id}/dismiss:
    post:
      operationId: NotificationsController_dismiss
      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: Dismiss a notification (hide from widget)
      tags:
      - Notifications
  /api/notifications/dismiss-all:
    post:
      operationId: NotificationsController_dismissAll
      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: Dismiss all notifications for the current user
      tags:
      - Notifications
      x-required-scope:
      - notifications:write
  /api/notifications/self-note:
    post:
      operationId: NotificationsController_createSelfNote
      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/CreateSelfNoteDto'
      responses:
        '201':
          description: ''
      security:
      - jwt: []
      summary: Create an agent self-note notification
      tags:
      - Notifications
      x-required-scope:
      - notifications:write
components:
  schemas:
    PushKeysDto:
      type: object
      properties:
        p256dh:
          type: string
          maxLength: 300
        auth:
          type: string
          maxLength: 100
      required:
      - p256dh
      - auth
    CreateSelfNoteDto:
      type: object
      properties:
        title:
          type: string
          description: Note title
        message:
          type: string
          description: Note text
      required:
      - title
      - message
    PushSubscribeDto:
      type: object
      properties:
        endpoint:
          type: string
          maxLength: 2048
        keys:
          $ref: '#/components/schemas/PushKeysDto'
        expirationTime:
          type:
          - number
          - 'null'
      required:
      - endpoint
      - keys
    PushUnsubscribeDto:
      type: object
      properties:
        endpoint:
          type: string
          maxLength: 2048
      required:
      - endpoint
  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.