---
title: API · Emails
description: POST /v1/emails — send, get, cancel, and batch. Fields, responses, and examples.
locale: en
---

# API · Emails

## POST /v1/emails

Also available as `POST /emails`.

### Body

| Field | Required | Notes |
|-------|----------|-------|
| `from` | yes | Verified domain or test sender |
| `to` | yes | string or array |
| `subject` | yes* | unless `template_id` |
| `html` / `text` | yes* | at least one, unless template |
| `cc`, `bcc`, `reply_to` | no | string or array |
| `headers`, `tags`, `attachments` | no | Resend-shaped |
| `scheduled_at` | no | ISO-8601 |

### Example

```bash
curl -X POST https://api.envimaily.com/v1/emails \
  -H "Authorization: Bearer em_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"onboarding@envimaily.com","to":["a@b.com"],"subject":"Hi","html":"<p>x</p>"}'
```

## GET /v1/emails/:id

Returns the send record.

## POST /v1/emails/:id/cancel

Cancels a scheduled send when supported.

## POST /v1/emails/batch

Up to **100** messages per batch: `{ "emails": [ … ] }`.