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-sdkfrom 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/sdkimport { 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