First email send

Send a first message and confirm the basic request flow.

SDK request

import { createHomailClientFromEnv } from "@shanehoban/homail";

const homail = createHomailClientFromEnv();

const queued = await homail.emails.send({
  to: "user@example.com",
  from: process.env.HOMAIL_FROM!,
  subject: "Welcome",
  text: "Thanks for signing up",
});

console.log(queued.message_id);

Successful response

json

{
  "message_id": "msg_...",
  "status": "queued"
}

What this means in practice

A successful request means homail has accepted the message and queued it for delivery. Final delivery can be checked later in the Homail dashboard or with raw API status endpoints.

Create API key

Using Homail from another app