Node.js

import { ByteSend } from "bytesend-js";

const bytesend = new ByteSend(process.env.BYTESEND_API_KEY!);

const email = await bytesend.emails.send({
  from: "[email protected]",
  to: "[email protected]",
  subject: "Hello from ByteSend",
  html: "<p>This email was sent via the ByteSend SDK.</p>",
  text: "This email was sent via the ByteSend SDK.",
});

console.log("Sent:", email.id);

const bytesend = new ByteSend(
  process.env.BYTESEND_API_KEY!,
  "https://your-bytesend-instance.com"
);

await bytesend.emails.send({
  from: "[email protected]",
  to: "[email protected]",
  subject: "Welcome!",
  html: "<h1>Welcome to our app</h1>",
});

await bytesend.emails.send({
  from: "[email protected]",
  to: ["[email protected]", "[email protected]"],
  subject: "Team announcement",
  html: "<p>Something big is happening.</p>",
});

await bytesend.emails.send({
  from: "[email protected]",
  to: "[email protected]",
  cc: "[email protected]",
  bcc: "[email protected]",
  replyTo: "[email protected]",
  subject: "Your support ticket",
  html: "<p>We've received your request.</p>",
});

await bytesend.emails.send({
  from: "[email protected]",
  to: "[email protected]",
  subject: "Scheduled message",
  html: "<p>This was scheduled ahead of time.</p>",
  scheduledAt: new Date("2026-07-01T09:00:00Z").toISOString(),
});

await bytesend.emails.send({
  from: "[email protected]",
  to: "[email protected]",
  subject: "Order confirmation",
  html: "<p>Your order #12345 has been confirmed.</p>",
  headers: {
    "X-Order-ID": "12345",
    "X-Customer-Tier": "premium",
  },
  metadata: {
    orderId: "12345",
    userId: "usr_abc",
  },
});

await bytesend.emails.sendBatch([
  {
    from: "[email protected]",
    to: "[email protected]",
    subject: "Your invoice",
    html: "<p>Invoice for Alice</p>",
  },
  {
    from: "[email protected]",
    to: "[email protected]",
    subject: "Your invoice",
    html: "<p>Invoice for Bob</p>",
  },
]);

import { ByteSend } from "bytesend-js";

const bytesend = new ByteSend(process.env.BYTESEND_API_KEY!);

try {
  const email = await bytesend.emails.send({
    from: "[email protected]",
    to: "[email protected]",
    subject: "Hello",
    html: "<p>Hello!</p>",
  });
  console.log("Email queued:", email.id);
} catch (error) {
  if (error instanceof Error) {
    console.error("Send failed:", error.message);
  }
}

const contact = await bytesend.contacts.create("your_contact_book_id", {
  email: "[email protected]",
  firstName: "Jane",
  lastName: "Smith",
  properties: {
    plan: "pro",
    signupSource: "landing-page",
  },
});

await bytesend.contacts.upsert("your_contact_book_id", {
  email: "[email protected]",
  firstName: "Jane",
  properties: { plan: "enterprise" },
});

await bytesend.contacts.update("contact_book_id", "contact_id", {
  subscribed: false,
});

import { ByteSend } from "bytesend-js";

const bytesend = new ByteSend(process.env.BYTESEND_API_KEY!);
const webhooks = bytesend.webhooks(process.env.BYTESEND_WEBHOOK_SECRET!);

// Next.js App Router example
export async function POST(request: Request) {
  const rawBody = await request.text();

  const event = webhooks.constructEvent(rawBody, {
    headers: request.headers,
  });

  switch (event.type) {
    case "email.delivered":
      console.log("Delivered to:", event.data.to);
      break;
    case "email.bounced":
      console.log("Bounced:", event.data.id, event.data.bounce?.type);
      break;
    case "email.complained":
      console.log("Complaint from:", event.data.to);
      break;
  }

  return new Response("ok");
}