API v2 /emails Endpoints Now Available

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
• Get Email
• Update Scheduled Email
• Cancel Email

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 or reach out to our support team.