Docs Send email

Send email

POST /api/v1/emails with X-API-Key and look up queued, sent, or failed.

Guide 04

Format HTTPS JSON

Base URL api.resendermail.com

Base URL

https://api.resendermail.com

The from address must be a sender identity on the key’s verified domain. to is an array of recipients. Include html, text, or both.

A successful send returns 200 with an email id and queued. Delivery is asynchronous.

Message status

Look up the id from the send response:

GET /api/v1/emails/{id} with X-API-Key.

Status is queued, processing, sent, or failed.

Errors

Failed requests return JSON with an error field.

401 — invalid API key
403 — unverified account or missing permission
422 — invalid payload
429 — rate limited

Replace the example from address with a sender identity on your verified domain. There is no customer SMTP relay, and there are no official SDKs — send JSON over HTTPS from your server.

Reusable bodies are next. See Templates. Today you still pass html or text on each request.

Example request

Live request shape

POST /api/v1/emails

curl -X POST https://api.resendermail.com/api/v1/emails \
  -H "X-API-Key: ep_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hello@yourdomain.com",
    "to": ["customer@example.com"],
    "subject": "Hello from ResenderMail",
    "html": "<p>Hello</p>"
  }'

const res = await fetch(
  "https://api.resendermail.com/api/v1/emails",
  {
    method: "POST",
    headers: {
      "X-API-Key": "ep_live_...",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      from: "hello@yourdomain.com",
      to: ["customer@example.com"],
      subject: "Hello from ResenderMail",
      html: "<p>Hello</p>",
    }),
  }
);
const { id, status } = await res.json();

import requests

resp = requests.post(
    "https://api.resendermail.com/api/v1/emails",
    headers={
        "X-API-Key": "ep_live_...",
        "Content-Type": "application/json",
    },
    json={
        "from": "hello@yourdomain.com",
        "to": ["customer@example.com"],
        "subject": "Hello from ResenderMail",
        "html": "<p>Hello</p>",
    },
)
data = resp.json()

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "ep_live_...");

using var content = new StringContent(
    """{"from":"hello@yourdomain.com","to":["customer@example.com"],"subject":"Hello from ResenderMail","html":"<p>Hello</p>"}""",
    Encoding.UTF8,
    "application/json"
);
var res = await client.PostAsync(
    "https://api.resendermail.com/api/v1/emails",
    content
);

var client = HttpClient.newHttpClient();
var req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.resendermail.com/api/v1/emails"))
    .header("X-API-Key", "ep_live_...")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("""
        {"from":"hello@yourdomain.com","to":["customer@example.com"],"subject":"Hello from ResenderMail","html":"<p>Hello</p>"}
        """))
    .build();
var res = client.send(req, HttpResponse.BodyHandlers.ofString());

payload := strings.NewReader("{\"from\":\"hello@yourdomain.com\",\"to\":[\"customer@example.com\"],\"subject\":\"Hello from ResenderMail\",\"html\":\"<p>Hello</p>\"}")
req, err := http.NewRequest(http.MethodPost, "https://api.resendermail.com/api/v1/emails", payload)
if err != nil {
    log.Fatal(err)
}
req.Header.Set("X-API-Key", "ep_live_...")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)

Example response

Response shape

200 api.resendermail.com

{
  "id": "em_4f2c…",
  "status": "queued"
}

Reference

Auth X-API-Key
Format application/json
Base URL https://api.resendermail.com