# API v2 /emails Endpoints Now Available

> Send, retrieve, update, and cancel emails programmatically with our new API v2 email endpoints.

2026-01-19 · George (https://x.com/thegeorge, https://www.linkedin.com/in/jiri-zizka/)

We're excited to announce that the **email endpoints are now available in API v2**! You can now send, retrieve, update scheduled emails, and cancel pending emails — all through our powerful REST API.

## New Endpoints

### Send Email

```
POST /v2/emails
```

Send a single email to one or multiple recipients. The send endpoint supports:

- **Multiple recipients** — Send to up to 50 recipients (TO, CC, BCC combined)
- **Templates** — Use template aliases or IDs with variable substitution using `{{variable}}` syntax
- **Attachments** — Include files via base64 content or URL
- **Scheduling** — Schedule emails for future delivery using ISO 8601, Unix timestamps, or natural language like "tomorrow at 9am"
- **Tracking** — Override domain tracking defaults for opens and clicks
- **Metadata** — Attach custom key-value pairs that are stored and returned with the email
- **Idempotency** — Prevent duplicate sends with the `Idempotency-Key` header

Each recipient receives their own unique email ID for individual tracking when sending to multiple addresses.

### Get Email

```
GET /v2/emails/{id}
```

Retrieve detailed information about a specific email, including:

- Current status (pending, scheduled, sent, delivered, bounced, canceled)
- Raw email headers and content
- Tracking settings
- Custom metadata
- Timestamps for creation and updates

### Update Scheduled Email

```
POST /v2/emails/{id}
```

Reschedule an email that's set for future delivery. You can change the scheduled time as long as the email is at least 3 minutes away from being sent.

### Cancel Email

```
POST /v2/emails/{id}/cancel
```

Cancel a scheduled or pending email before it's sent. For scheduled emails, cancellation must be requested at least 3 minutes before the scheduled send time.

## Rate Limits

Every response includes rate limit headers so you can monitor your usage:

- `ratelimit-limit` — Maximum requests per second
- `ratelimit-remaining` — Remaining requests in current second
- `ratelimit-daily-limit` — Maximum daily requests
- `ratelimit-daily-remaining` — Remaining daily requests

## Documentation

Full documentation with code examples in Node.js, PHP, Python, Ruby, Go, Rust, Java, .NET, and cURL is available:

- [Send Email](https://emailit.com/docs/api-reference/emails/send)
- [Get Email](https://emailit.com/docs/api-reference/emails/get)
- [Update Scheduled Email](https://emailit.com/docs/api-reference/emails/update)
- [Cancel Email](https://emailit.com/docs/api-reference/emails/cancel)

## Coming Soon: Templates API

We're working on the **Templates API** which will allow you to create, update, and manage email templates programmatically. Stay tuned for this exciting addition!

## API v1 Deprecation Notice

**Important:** API v1 has been deprecated and will cease to function at the end of February 2026. If you're still using API v1, please migrate to API v2 as soon as possible.

Need help migrating? Check out our [API v2 documentation](https://emailit.com/docs/api-reference) or reach out to our support team.

---

Source: https://emailit.com/blog/api-v2-emails-endpoints/
