API v2
Send email, manage subscribers, campaigns, and domains. Auth is a Bearer lum_ token.
- Base URL:
https://lumail.io/api/v2 - Auth:
Authorization: Bearer lum_...(create a token) - Email body: exactly one of
html,tiptap, ormarkdown - Rewrite a v1 integration: Migration to V2
- Spec: openapi.json
- Limits: Rate limits
Send an email
curl -X POST https://lumail.io/api/v2/emails \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"from": "[email protected]",
"to": "[email protected]",
"subject": "Welcome",
"html": "<p>Hello</p>"
}'Returns { "id": "eml_..." }. Full contract: Send Email.
Every v2 error uses { name, message, statusCode } plus optional details. 429 includes Retry-After. Lists use { object: "list", data, has_more } with limit / after / before.
Resources
EmailsSend, batch, inspect, and verify transactional mail.
SubscribersList, create, tag, and unsubscribe contacts.
TagsList, create, and rename audience tags.
EventsRecord a payment or refund on a subscriber.
DomainsCreate and verify sending domains.
CampaignsDraft, edit, schedule, and delete campaigns.
TokensList and mint organization lum_ tokens.
ToolsSame operations as MCP, over HTTP.