# Email Sending

Send transactional and marketing emails via REST API.
Simple API for sending individual emails with full tracking support.


## Send a single email

 - [POST /api/send](https://developers.mailerlogic.com/customer-api.openapi/email-sending/paths/~1api~1send/post.md): Send a single transactional or marketing email via REST API.

Simple API for sending emails with:
- Automatic queuing and delivery
- Built-in tracking (opens & clicks)
- Template variable support
- Custom headers
- Full bounce and complaint handling

Requirements:
- Verified sending domain
- Active customer account
- Valid API key

Auto-domain selection: If you don't specify a domain, we'll automatically use your first verified domain.

## Send batch of different emails

 - [POST /api/batch](https://developers.mailerlogic.com/customer-api.openapi/email-sending/paths/~1api~1batch/post.md): Send up to 500 completely different emails in a single API call.

Batch sending where each email can have:
- Different recipient
- Different subject
- Different content
- Different settings

Perfect for sending multiple transactional emails at once (order confirmations, password resets, etc.).

Limits:
- Maximum 500 emails per batch
- Each email validated independently
- Failed emails don't affect successful ones

Use cases:
- Sending different transactional emails simultaneously
- Mixed email types in one API call
- High-volume transactional sending

Not for: Newsletter-style emails with same content → Use /api/bulk-send instead

## Send bulk emails (mail merge)

 - [POST /api/bulk-send](https://developers.mailerlogic.com/customer-api.openapi/email-sending/paths/~1api~1bulk-send/post.md): Send the same email template to multiple recipients with personalization.

Mail merge functionality for:
- Newsletters with personalized greetings
- Marketing campaigns with custom variables
- Bulk transactional emails with recipient-specific data

Features:
- Template variables: Use {{variable}} syntax in subject, HTML, and text
- Per-recipient personalization via vars object
- Automatic variable substitution for each recipient
- Single template, many recipients

Limits:
- Recommended: Up to 10,000 recipients per call
- Each recipient gets their own personalized copy

Use cases:
- Newsletter campaigns: "Hi {{name}}, check out our new {{product}}..."
- Promotional emails with unique discount codes
- Event invitations with personalized details

Not for: Different emails to each recipient → Use /api/batch instead