Send email with Node.js

export TINYRELAY_API_KEY="your-api-key"

$env:TINYRELAY_API_KEY = "your-api-key"

const email = {
  subject: "Order SO-1001 is confirmed",
  body: "<p>Hi [FIRST_NAME], thanks for your order. We will email you again when it ships.</p>",
  sender: {
    from: { name: "Acme Store", email: "orders@acme.com" },
    replyTo: { name: "Acme Support", email: "support@acme.com" },
  },
  recipients: {
    to: [
      { name: "Ann Lee", email: "ann@example.com", attributes: { FIRST_NAME: "Ann" } },
    ],
  },
  campaignId: "order_confirmed_SO-1001",
  metadata: { order_id: "SO-1001", tenant_id: "acme" },
};

// tinyrelay.mjs
const API_URL = "https://api.tinyemail.com/v1/relay/email/campaign";

export async function sendEmail(email) {
  const res = await fetch(API_URL, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-RELAY-ACCESS-TOKEN": process.env.TINYRELAY_API_KEY,
    },
    body: JSON.stringify(email),
  });
  if (res.status !== 202) {
    throw new Error(`tinyRelay ${res.status}: ${await res.text()}`);
  }
  const { requestId } = await res.json();
  return requestId;
}

// tinyrelay.mjs  (npm install axios)
import axios from "axios";

const tinyRelay = axios.create({
  baseURL: "https://api.tinyemail.com/v1/relay",
  timeout: 10000,
  headers: { "X-RELAY-ACCESS-TOKEN": process.env.TINYRELAY_API_KEY },
});

export async function sendEmail(email) {
  try {
    const { data } = await tinyRelay.post("/email/campaign", email);
    return data.requestId;
  } catch (err) {
    // axios rejects any non-2xx status
    if (err.response) {
      throw new Error(`tinyRelay ${err.response.status}: ${JSON.stringify(err.response.data)}`);
    }
    throw err;
  }
}

// tinyrelay.mjs  (no dependencies)
import https from "node:https";

const API_URL = "https://api.tinyemail.com/v1/relay/email/campaign";

export function sendEmail(email) {
  const payload = JSON.stringify(email);
  return new Promise((resolve, reject) => {
    const req = https.request(API_URL, {
      method: "POST",
      timeout: 10000,
      headers: {
        "Content-Type": "application/json",
        "Content-Length": Buffer.byteLength(payload),
        "X-RELAY-ACCESS-TOKEN": process.env.TINYRELAY_API_KEY,
      },
    }, (res) => {
      let body = "";
      res.setEncoding("utf8");
      res.on("data", (chunk) => (body += chunk));
      res.on("end", () => {
        if (res.statusCode === 202) resolve(JSON.parse(body).requestId);
        else reject(new Error(`tinyRelay ${res.statusCode}: ${body}`));
      });
    });
    req.on("timeout", () => req.destroy(new Error("tinyRelay request timed out")));
    req.on("error", reject);
    req.end(payload);
  });
}

{
  "requestId": "833c5151-5a98-4bad-a30f-7cc816352b7a",
  "message": "SUCCESS"
}

const requestId = await sendEmail({
  subject: "Your order is confirmed",
  body: "<p>Hi [FIRST_NAME], order [ORDER_ID] is confirmed.</p>",
  sender: { from: { name: "Acme Store", email: "orders@acme.com" } },
  metadata: { tenant_id: "acme", app: "checkout" },
  recipients: {
    to: orders.map((o) => ({
      name: o.customerName,
      email: o.customerEmail,
      attributes: { FIRST_NAME: o.firstName, ORDER_ID: o.id },
      metadata: { order_id: o.id },
    })),
  },
});