- Base URL: `https://lumail.io/api/v2`
- Auth: `Authorization: Bearer lum_...` ([create a token](/docs/api-reference/api-tokens))
- Email body: exactly one of `html`, `tiptap`, or `markdown`
- Rewrite a v1 integration: [Migration to V2](/docs/api-reference/v2/migration)
- Spec: [openapi.json](https://lumail.io/openapi.json)
- Limits: [Rate limits](/docs/api-reference/api-limits)

## Send an email

```bash
curl -X POST https://lumail.io/api/v2/emails \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hello@yourdomain.com",
    "to": "user@example.com",
    "subject": "Welcome",
    "html": "<p>Hello</p>"
  }'
```

Returns `{ "id": "eml_..." }`. Full contract: [Send Email](/docs/api-reference/v2/emails-send).

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

<DocCardWrapper>
  <DocCardGrid>
    <DocCard
      href="/docs/api-reference/v2/emails"
      icon="Mail"
      title="Emails"
      description="Send, batch, inspect, and verify transactional mail."
    />
    <DocCard
      href="/docs/api-reference/v2/subscribers"
      icon="Users"
      title="Subscribers"
      description="List, create, tag, and unsubscribe contacts."
    />
    <DocCard
      href="/docs/api-reference/v2/tags"
      icon="Tag"
      title="Tags"
      description="List, create, and rename audience tags."
    />
    <DocCard
      href="/docs/api-reference/v2/events"
      icon="Webhook"
      title="Events"
      description="Record a payment or refund on a subscriber."
    />
    <DocCard
      href="/docs/api-reference/v2/domains"
      icon="Globe"
      title="Domains"
      description="Create and verify sending domains."
    />
    <DocCard
      href="/docs/api-reference/v2/campaigns"
      icon="FileText"
      title="Campaigns"
      description="Draft, edit, schedule, and delete campaigns."
    />
    <DocCard
      href="/docs/api-reference/v2/tokens"
      icon="Key"
      title="Tokens"
      description="List and mint organization lum_ tokens."
    />
    <DocCard
      href="/docs/api-reference/v2/tools"
      icon="Settings"
      title="Tools"
      description="Same operations as MCP, over HTTP."
    />
  </DocCardGrid>
</DocCardWrapper>