Docs Get started

Get started

Create an account, verify a sending domain, and make your first API request.

Guide 01

Format HTTPS JSON

ResenderMail sends transactional email from a domain you already own. You do not move MX or existing mailboxes.

1. Create an account

Open app.resendermail.com/register, create an organization, and sign in.

2. Add a sending domain

In the dashboard, add the domain you will send from (for example yourdomain.com). Publish the DNS records the dashboard shows:

SPF — authorize ResenderMail to send
DKIM — sign messages
DMARC — tell inboxes how to treat unauthenticated mail
Ownership TXT — prove you control the domain

Keep receiving mail on your current host. This product is sending-only.

3. Create an API key

Keys are scoped to one verified domain. The secret is shown once — copy it into your server environment as RESENDERMAIL_API_KEY. Never put keys in frontend code or git.

4. Register a sender identity

The from address must be a sender identity on that verified domain (for example hello@yourdomain.com).

5. Send

POST https://api.resendermail.com/api/v1/emails with X-API-Key and JSON. See Send email. Look up status with GET /api/v1/emails/{id}.

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