Agentuity Documentation

Email

Email lets your app send outbound messages and inspect delivery state. This demo previews a transactional email, sends it to an address you control, and reads delivery status so the UI can show what happened. Use it for emails such as receipts, notifications, invites, and inbound flows.

Fromhello-explorer@agentuity.email

Send this demo to an inbox you can check. The Preview tab matches the delivered HTML.

Enter a valid email address.

SubjectHello from the Agentuity SDK Explorer

import { EmailClient } from "@agentuity/email";

const email = new EmailClient();

await email.send({
  from: "hello-explorer@agentuity.email",
  to: ["you@example.com"],
  subject: "Hello from the Agentuity SDK Explorer",
  html: "<p>This email was sent by an Agentuity app...</p>",
  text: "This email was sent by an Agentuity app...",
});

This is a demo email from Agentuity's SDK Explorer.

It was sent through the Email service.

Agentuity apps can also use queues, databases, webhooks, scheduled tasks, and more.

Reference Code

import { EmailClient } from "@agentuity/email";

const email = new EmailClient();

const outbound = await email.send({
  from: "hello-explorer@agentuity.email",
  to: ["inbox-explorer@agentuity.email"],
  subject: "Hello from the Agentuity SDK Explorer",
  text: "This is a demo email from Agentuity's SDK Explorer.",
  html: "<p>This is a demo email from Agentuity's SDK Explorer, sent with <code>email.send()</code>.</p>",
});

const latest = await email.getOutbound(outbound.id);
const outbox = await email.listOutbound();
const activity = await email.getActivity({ days: 7 });

export const status = {
  outboundId: outbound.id,
  status: latest?.status ?? outbound.status,
  listed: outbox.some((message) => message.id === outbound.id),
  activityDays: activity.activity.length,
};

Ready

Output will appear here...