# AgenticEmail

> API-first email infrastructure for AI agents. Create inboxes on the fly, send and receive email over a REST API, and get webhooks, real-time events, custom domains, SDKs, and an MCP server.

AgenticEmail gives AI agents a real, two-way inbox in a single API call. Provision addressable inboxes at runtime, send transactional or conversational email with threading and attachments, and receive inbound mail parsed as structured JSON. Every message triggers a signed webhook and a real-time WebSocket event so agents act on email the instant it arrives.

The Free tier includes inboxes, sending, and real-time events. Pro and Enterprise add custom domains, scoped API keys, MCP server access, higher volume, dedicated IPs, and SMTP/IMAP.

## When to use AgenticEmail

Reach for AgenticEmail when:
- An AI agent needs its own real, addressable email inbox (one per agent, task, or customer), created at runtime with one API call.
- An agent must receive and act on inbound email: messages arrive parsed as structured JSON with threading, no MIME handling, delivered by signed webhook or WebSocket the moment they land.
- An agent holds email conversations: reply and forward endpoints manage recipients, subjects, and threading automatically.
- An agent sends transactional or conversational email from a workflow, optionally from your own domain with automated SPF, DKIM, and DMARC.
- A model-based agent should use email as a native tool via the hosted MCP server (Streamable HTTP) at https://api.agenticemail.dev/mcp.

It is not a bulk-marketing or newsletter-blast tool.

How to call it: authenticate with a Bearer API key (`Authorization: Bearer am_...`), then `POST /v1/inboxes` to create an address, `POST /v1/inboxes/{inbox_id}/messages/send` to send, and register a webhook or WebSocket to receive. Full walkthrough: https://agenticemail.dev/agents.md.

## Agent resources

- [OpenAPI 3.0 spec](https://agenticemail.dev/openapi.json): the full API surface (also at https://api.agenticemail.dev/openapi.json). Base URL: https://api.agenticemail.dev.
- [auth.md](https://agenticemail.dev/auth.md): how agents obtain, use, and revoke API credentials.
- [agents.md](https://agenticemail.dev/agents.md): when to use AgenticEmail and how to integrate, for agents.
- [Agent view](https://agenticemail.dev/agent): machine-readable JSON summary (also at https://agenticemail.dev/?mode=agent).
- MCP server: https://api.agenticemail.dev/mcp (Streamable HTTP, Bearer API key). Server card: https://agenticemail.dev/.well-known/mcp/server-card.json.
- [Protected resource metadata (RFC 9728)](https://agenticemail.dev/.well-known/oauth-protected-resource) and [API catalog (RFC 9727)](https://agenticemail.dev/.well-known/api-catalog).
- [Agent skills index](https://agenticemail.dev/.well-known/agent-skills/index.json) and [agent card](https://agenticemail.dev/.well-known/agent-card.json).
- Markdown twins: append .md to any docs URL (e.g. https://agenticemail.dev/docs/quickstart.md); the homepage is at https://agenticemail.dev/index.md.
- GitHub: https://github.com/AgenticEmail

## Key pages
- [Home](https://agenticemail.dev/): What AgenticEmail does - programmatic inboxes, send, receive, and events for agents.
- [Pricing](https://agenticemail.dev/pricing): Free, Pro, and Enterprise. Machine-readable at https://agenticemail.dev/pricing.md.
- [Docs](https://agenticemail.dev/docs): Quickstart - install the SDK, create an inbox, send email, and receive via webhook or WebSocket. Scoped index: https://agenticemail.dev/docs/llms.txt.
- [About](https://agenticemail.dev/about), [Contact](https://agenticemail.dev/contact), [Privacy](https://agenticemail.dev/privacy).

## What AgenticEmail provides
- Programmatic inboxes: create, list, and delete addressable inboxes at runtime, organized with labels and lists.
- Send and receive: a REST API for outbound and inbound email, with threading, attachments, and parsed JSON.
- Webhooks and real-time events: signed webhooks and a WebSocket stream for inbound messages, deliveries, opens, and bounces.
- Custom domains: bring your own domain with automated SPF, DKIM, and DMARC.
- SDKs and MCP: type-safe TypeScript and Python SDKs plus a hosted MCP server.

## Documentation
- [Introduction](https://agenticemail.dev/docs): What AgenticEmail is and how to install the SDK and authenticate.
- [MCP server](https://agenticemail.dev/docs/mcp): Give any model-based agent email as a native tool with the AgenticEmail MCP server.
- [Using the dashboard](https://agenticemail.dev/docs/dashboard): A tour of the AgenticEmail dashboard - inboxes, the email client, API keys, domains, webhooks, the AI assistant, and settings.
- [Receiving email](https://agenticemail.dev/docs/receiving): React to inbound email in real time with webhooks and WebSocket events.
- [Quickstart](https://agenticemail.dev/docs/quickstart): Create an inbox and send your first email with the AgenticEmail SDK.

## Blog
Guides and references on email infrastructure for agents (each has an FAQ section):
- [Temp mail API: create disposable inboxes programmatically](https://agenticemail.dev/blog/temp-mail-api): A temp mail API creates disposable email inboxes from code - for OTP testing, signup QA, and agents. Working curl, TS, and Python examples.
- [How to Send Email from JavaScript: SMTP, fetch, and the Email API Way](https://agenticemail.dev/blog/send-email-api-javascript): You can't send email from browser JavaScript directly. Here's how to use a send email API in JavaScript, nodemailer over SMTP, or a plain fetch call.
- [Gmail API send email: a working Python and Node.js guide](https://agenticemail.dev/blog/gmail-api-send-email): Gmail API send email tutorial with working Python and Node.js code, OAuth setup, base64url encoding, quotas, and when an API-first inbox fits better.
- [SendGrid Inbound Parse: the complete setup and troubleshooting guide](https://agenticemail.dev/blog/sendgrid-inbound-parse): Set up the SendGrid Inbound Parse webhook end to end - MX record, dashboard config, the multipart payload fields - plus fixes for when it is not working.
- [SendGrid API: how to send email with the v3 Mail Send API](https://agenticemail.dev/blog/sendgrid-api-send-email): A working tutorial to send email with the SendGrid API - curl and Node.js code, API key setup, sender verification, and fixes for the common 401 and 403 errors.
- [SendGrid webhook: the complete Event Webhook guide](https://agenticemail.dev/blog/sendgrid-webhook): How the SendGrid webhook works - the events it sends, how to configure it, verifying the ECDSA signature, retry behavior, and why it fails.
- [The best email validation API in 2026: an honest comparison](https://agenticemail.dev/blog/email-validation-api): An honest 2026 comparison of email validation API providers - free tiers, accuracy, and the validation layers that predict deliverability before you send.
- [Email webhooks: how to receive email as JSON](https://agenticemail.dev/blog/email-webhook): An email webhook POSTs inbound mail to your endpoint as JSON. Learn what an email webhook is, how to receive one, verify signatures, and pick a provider.
- [Give your AI agent an inbox in five minutes](https://agenticemail.dev/blog/give-your-agent-an-inbox): Create a real email address for your agent with one API call, receive inbound mail as a webhook or WebSocket event, and reply over REST - no IMAP, no OAuth dance, no mail server.
- [The 5 best email APIs for developers in 2026](https://agenticemail.dev/blog/best-email-api): The best email API depends on your job: SendGrid, Mailgun, Postmark, Resend, or AgenticEmail. An honest 2026 comparison for developers.
- [Mailgun webhook guide: events, Routes, and signature verification](https://agenticemail.dev/blog/mailgun-webhook): A complete Mailgun webhook guide - event webhooks vs inbound Routes, the payload shape, HMAC signature verification in Node, retries, and testing.
- [Gmail webhook: how to get a real-time push when email arrives](https://agenticemail.dev/blog/gmail-webhook): Gmail has no native webhook. Here is how to build one with Gmail API push notifications and Cloud Pub/Sub, plus simpler alternatives for agents.
- [Transactional email API: the definitive guide for 2026](https://agenticemail.dev/blog/transactional-email-api): What a transactional email API is, how it differs from marketing email, and how to choose one - deliverability, webhooks, idempotency, and two-way replies.
- [What does queued mean in email? A plain-English guide](https://agenticemail.dev/blog/what-does-queued-mean-email): What does queued mean in email? A guide to the queued status in Gmail, Outlook, and on mail servers, plus how sending queues work for developers.
- [Noreply email addresses: what they are and why to stop using them](https://agenticemail.dev/blog/noreply-email-address): What a noreply email address is, why companies use noreply@, and the 2026 case against it - deliverability, trust, and the reply-capable alternative.
- [BCC in email: what it means and when to use it](https://agenticemail.dev/blog/bcc-in-email): BCC in email means blind carbon copy. Learn what BCC means, how it differs from CC, when to use it, and how to send BCC in Gmail, Outlook, and code.
- [Scoped API keys, WebSocket events, batch sending, scheduled sends, and SMTP](https://agenticemail.dev/blog/scoped-keys-websockets-batch-smtp): A big infrastructure drop: per-inbox scoped keys, a real-time WebSocket event stream, batch and scheduled sending, and an SMTP gateway for everything that speaks classic email.
- [Why AI agents need their own email infrastructure](https://agenticemail.dev/blog/why-agents-need-email-infrastructure): Email is the universal API between businesses - and agents are terrible tenants in human inboxes. Why borrowing a Gmail account does not scale, and what agent-native email looks like.

## Optional
- [llms-full.txt (more detail)](https://agenticemail.dev/llms-full.txt)