Email for agents

Extrovert gives an agent its own email address without exposing a human account or an organization-wide credential. Each agent key is bound to an organization and project, limited by explicit permissions, and independently revocable.

create-inbox.ts

import { Extrovert } from "@extrovert.dev/sdk";

const extrovert = new Extrovert({ apiKey: process.env.EXTROVERT_API_KEY! });
const inbox = await extrovert.inboxes.create({ display_name: "Support agent" });

const outcome = await inbox.send({
  to: "ops@acme.test",
  subject: "Support inbox ready",
  text: "The support inbox is ready.",
  intent: { summary: "Tell operations that the support inbox is ready" },
});

By default, outbound mail waits for human review. The send returns a review id rather than claiming that the message was delivered. A human can later allow direct sending or enable graduated auto-send.

Core capabilities

Create an inbox

Paid accounts use extrovertmail.com by default, or you can select a verified domain you control.

Wait for incoming mail

wait_for_email blocks until a matching message arrives and returns the message, OTP code, and verification link when present.

Limit access

Enrollment keys create agents. API keys connect existing agents. Both are project-bound and carry only the permissions you select.

Review outbound mail

Send, reply, and forward requests all follow the inbox’s effective review policy. Agents cannot widen that policy.

Choose an integration

Create an inbox Use curl, the TypeScript SDK, or MCP.

Connect MCP Use hosted OAuth or the packaged local server.

Understand the model Agents, projects, credentials, inboxes, domains, and review policy.

Read the API reference Endpoints, request bodies, responses, and errors.

---

Extrovert is a product of Message Science.