Send Email

POST /v1/emails

Queues a transactional email from one of your verified domains. The request returns as soon as the email is validated and stored; a worker sends it moments later, respecting the platform’s provider rate limit and retrying transient failures automatically. For many emails at once, use Send Batch.

Request body

* At least one of html or text is required; you can provide both.

Example

import { Retransmit } from "retransmit.dev";
 
const retransmit = new Retransmit(process.env.RETRANSMIT_API_KEY);
 
const { data, error } = await retransmit.emails.send({
  from: "Acme <hello@yourdomain.com>",
  to: ["user@example.com"],
  replyTo: "support@yourdomain.com",
  subject: "Your receipt",
  html: "<p>Thanks for your order!</p>",
  text: "Thanks for your order!",
});

curl -X POST https://api.retransmit.dev/v1/emails \
  -H "Authorization: Bearer $RETRANSMIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@yourdomain.com>",
    "to": ["user@example.com"],
    "reply_to": "support@yourdomain.com",
    "subject": "Your receipt",
    "html": "<p>Thanks for your order!</p>",
    "text": "Thanks for your order!"
  }'

Response

202 Accepted

{
  "id": "em_xxxxxxxxxxxx",
  "status": "queued",
  "created_at": "2026-09-01T12:00:00.000Z"
}

Keep the id — it’s how you look the email up and how webhook events reference it (emailId). The status moves from queued to sent once the worker hands it to the provider (usually within seconds), then onward as delivery events arrive. If every send retry fails, it ends up as failed with the provider error recorded — you’ll get an email.failed webhook if you subscribe to it.

Errors