Documentation
Getting started

Quickstart

Send your first message in 5 minutes.

1

Get your API key

Sign up at /signup — free, 500 deliveries forever. Your API key will appear on the dashboard immediately.


2

Send a message

curl

curl -X POST https://api.live-direct-marketing.online/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "test@example.com",
    "subject": "Hello from my agent",
    "body": "This is my first message via LDM.",
    "from_pool": "managed"
  }'

Response

{
  "message_id": "msg_01HQX7kP...",
  "status": "queued",
  "creative_id": "cr_9f2a...",
  "moderation_status": "pending"
}

Python

pip install ldm-sdk
from ldm import Client

client = Client(api_key="YOUR_API_KEY")

response = client.messages.send(
    to="test@example.com",
    subject="Hello from my agent",
    body="This is my first message via LDM.",
    from_pool="managed"
)
print(response.message_id)

Node.js

npm install @live-direct-marketing/sdk
import { Client } from '@live-direct-marketing/sdk';

const client = new Client({ apiKey: 'YOUR_API_KEY' });

const response = await client.messages.send({
  to: 'test@example.com',
  subject: 'Hello from my agent',
  body: 'This is my first message via LDM.',
  fromPool: 'managed'
});

console.log(response.messageId);

3

Handle the reply

Register a webhook URL in the Dashboard to receive replies in real time. LDM will POST to your endpoint when the recipient replies:

POST https://your-app.com/webhooks/ldm
Content-Type: application/json
X-LDM-Signature: sha256=abc123...

{
  "event": "reply.received",
  "message_id": "msg_01HQX7kP...",
  "from": "test@example.com",
  "subject": "Re: Hello from my agent",
  "body": "Thanks for reaching out! Let's schedule a call.",
  "received_at": "2026-04-16T10:30:00Z"
}

4

Billing

You only pay $0.015 when the message is confirmed in the recipient's inbox. You don't pay for messages that land in spam or bounce.

  • Inbox confirmed — charged $0.015
  • Spam folder — not charged
  • Bounced — not charged

Next steps