Sending
Send a message
Deliver a message to any email address with inbox verification.
POST/v1/messages
Send a message to a recipient. The message will be queued for delivery and moderated automatically.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
to | string | Yes | Recipient email address. |
subject | string | Yes | Email subject line. |
body | string | Yes | Plain text or HTML body. |
from_pool | string | Yes | "managed" (LDM selects sender) or "byo" (bring your own domain). |
creative_id | string | No | Pre-approved creative ID. If omitted, a new creative is created automatically. |
Example request
curl -X POST https://api.live-direct-marketing.online/v1/messages \
-H "Authorization: Bearer ldm_live_sk_abc123..." \
-H "Content-Type: application/json" \
-d '{
"to": "cto@acme.com",
"subject": "Quick question about your infrastructure",
"body": "Hi, I noticed your team is scaling fast...",
"from_pool": "managed"
}'Response
| Field | Description |
|---|---|
message_id | Unique identifier for tracking. |
status | Current delivery status. |
creative_id | Associated creative identifier. |
moderation_status | Creative moderation result. |
{
"message_id": "msg_01HQX7kP...",
"status": "queued",
"creative_id": "cr_9f2a...",
"moderation_status": "pending"
}Delivery statuses
A message progresses through these statuses:
queued→sent→inbox|spam|bounce
- ●queued — Message accepted, awaiting moderation and send.
- ●sent — Message left our servers.
- ●inbox — Confirmed in recipient's inbox. You are charged.
- ●spam — Landed in spam. Not charged.
- ●bounce — Delivery failed. Not charged.
GET/v1/messages/:id
Check the delivery status of a specific message.
Example request
curl https://api.live-direct-marketing.online/v1/messages/msg_01HQX7kP... \
-H "Authorization: Bearer ldm_live_sk_abc123..."Response
{
"message_id": "msg_01HQX7kP...",
"to": "cto@acme.com",
"subject": "Quick question about your infrastructure",
"status": "inbox",
"creative_id": "cr_9f2a...",
"moderation_status": "approved",
"sent_at": "2026-04-16T09:00:00Z",
"delivered_at": "2026-04-16T09:00:12Z"
}Related
- ●Webhooks— get notified about delivery events.
- ●Creative moderation— pre-approve content to avoid delays.
- ●Error codes— handle failures gracefully.