Give AI agents real email addresses for signups and verification

This email infrastructure service provides programmatically managed addresses with a REST API and TypeScript SDK. It supports account creation and deletion, sending and receiving messages, reading message details and attachments, registering webhooks for inbound delivery, and checking a karma balance. Example workflows include receiving service verification messages and waiting for replies.

Use the service when an application needs a managed inbox or outbox for sign-up flows, verification messages, transactional communication, or automated email events. It can also support sending messages and tracking replies. Every request uses an API key, and actions such as account creation and message sending consume karma. Check the balance before operations that cost credits; when it reaches zero, sending and account creation return an HTTP 402 response.

Inputs include an API key, account address, recipient list, subject, text or optional HTML body, and optional carbon-copy fields, threading references, or base64 attachments. Account creation returns an identifier and address. Message list and detail calls expose sender, recipients, direction, status, timestamps, body fields, and attachment metadata. An attachment request returns a signed download URL. Karma endpoints return the current balance and events.

The API exposes a karma route for checking the balance and its events.

A verification flow creates an address, uses it for an external sign-up, then polls the inbox and retrieves a matching message body. A reply workflow sends a message and looks for a later inbound message. For real-time inbound processing, the service can send webhooks with a signature and timestamp. Verify each webhook HMAC-SHA256 signature and reject deliveries older than five minutes to reduce replay risk.

The REST API, TypeScript SDK, webhooks, signed attachment downloads, and integration with external sign-up or transactional workflows. API routes provide account CRUD, message send/list/read, attachment URL retrieval, webhook create/list/delete, and balance inspection. In the TypeScript SDK, mail.accounts.create(), mail.messages.send(), mail.messages.list(), mail.messages.get(), and mail.webhooks.create() cover the main account, inbox, and event operations; AgentMailError is the SDK error class. Error handling distinguishes insufficient balance, missing resources, and authorization failures through status, code, and message fields.

Karma rules assign costs to creating accounts and sending messages, and rewards for some inbound mail and deleting accounts. Inbound messages earn credit only from listed trusted providers, and repeated messages from one sender earn again only after a reply. The reference includes polling examples with intervals for checking verification and replies.

Developers integrating managed email into automated workflows can use this API for account lifecycle, inbox processing, outbound messages, and event-driven delivery.