Guides

Build useful email workflows

Every guide here is written against the code that is deployed: real error codes, real limits, real request shapes. 18 published, newest first.

permissions 9 api 7 inboxes 6 reliability 6 approvals 4 mcp 4 setup 4 webhooks 4 foundations 3 use-cases 3 events 2 security 2

Developers · Sep 21, 2026 · 11 min

Accepted vs Delivered: What an Email Status Proves

Queued, accepted, delivered, bounced, unknown — what each email status actually proves, what it does not, and the correct next action for every one of them.

Developers · Sep 21, 2026 · 9 min

Agent Email API: Send, Receive and Reply in One Loop

Build the full two-way loop over REST: scoped keys, idempotent sends, the states a message moves through, inbound events, and replies that thread correctly.

Controls · Sep 21, 2026 · 11 min

Scoped Credentials for Agent Email: Read, Draft, Send

Give an agent the smallest useful email permission: project and inbox scoping, one-time secrets, draft-only grants, rotation, and revocation you can verify.

Inboxes · Sep 21, 2026 · 11 min

Agent Email on a Subdomain Without Breaking Company Mail

Run agent mail on agents.yourcompany.com: inspect existing MX, publish ownership, SPF, DKIM and receiving records, and leave employee routing untouched.

Inboxes · Sep 21, 2026 · 11 min

Run Support Triage From an Agent's Own Inbox

A working pattern for support triage: one dedicated address, read and draft permission, approval on anything money-related, and events that prove it worked.

Inboxes · Sep 21, 2026 · 9 min

AI Agent Inbox vs Connecting Gmail: How to Choose

Giving an agent its own inbox versus wiring it into an existing Gmail or Microsoft 365 mailbox: identity, blast radius, OAuth scope and revocation.

Email for Agents · Sep 21, 2026 · 10 min

Email for AI Agents: How Agent Inboxes Actually Work

What an email inbox for an AI agent is, how mail arrives and leaves, which permissions matter, and when an agent needs its own address instead of yours.

Developers · Sep 21, 2026 · 11 min

Keep an Agent's Replies in the Right Email Thread

How Message-ID, In-Reply-To and References decide threading, why subject matching breaks, and how to keep an agent reply in the right conversation.

Inboxes · Sep 21, 2026 · 11 min

Signup and Verification Codes in an Agent's Inbox

Agents that create accounts need a real mailbox for verification email. How to provision one, read the code safely, and where this becomes unacceptable use.

Developers · Sep 21, 2026 · 11 min

Handle Email Webhooks Without Processing Events Twice

Verify the signature against the raw body, deduplicate by event ID, enqueue durably, and keep a webhook retry from re-sending the email that produced it.

Integrations · Sep 21, 2026 · 8 min

How to Give an AI Agent Its Own Email Address

Create a dedicated inbox, choose read, draft or send permission, connect over MCP or a scoped key, and prove a real round trip before granting send access.

Controls · Sep 21, 2026 · 11 min

Human Approval Before an AI Agent Sends Email

When to require review, why approval binds to one exact draft version, how recipient rules and daily caps work, and what editing a draft does to its approval.

Inboxes · Sep 21, 2026 · 11 min

Invoice Intake Through an Agent Email Inbox

Receive invoices at a dedicated address, scan attachments before the agent acts, draft the confirmation, and require approval before anything is sent back.

Integrations · Sep 21, 2026 · 9 min

MCP Email Server: Give Your Agent Client a Real Inbox

How a remote MCP email server works, what the consent screen must show, how to scope a grant to one inbox, and how to verify it before allowing sends.

Controls · Sep 21, 2026 · 11 min

Prompt Injection by Email: What Actually Helps

Any stranger can email your agent. What an email-borne injection looks like, why message text must never grant permission, and the controls that limit damage.

Developers · Sep 21, 2026 · 8 min

Test an Agent's Email Without Sending Real Mail

Use non-routable test inboxes to simulate inbound mail, exercise drafts, approvals and webhooks, and verify agent behavior before a live message goes out.

Integrations · Sep 20, 2026 · 6 min

MCP or API Key for Agent Email? How to Choose

Remote MCP over OAuth or a project-scoped REST key: what each can and cannot do, who authorises it, how revocation differs, and why teams use both.

Developers · Sep 20, 2026 · 7 min

Idempotency Keys: Stop an Agent Sending Duplicate Emails

How send idempotency works: canonical payload hashing, the 30-day replay window, conflict versus expiry, and why retrying an unknown outcome is unsafe.

Looking for setup steps? Open the documentation. Prefer a reader? Subscribe to the feed.