# Documentation

- [Documentation built around the real delivery path](/docs): Learn how to verify domains, send email, receive inbound traffic, subscribe to webhooks, and move safely into production with Bavimail.

- **Getting started**
- [From install to first email — typically under 5 minutes](/docs/quickstart): Install the SDK, set your API key, and send your first email.
- [API key authentication for every request](/docs/authentication): Create a key in the dashboard, pass it as a Bearer token, and start sending.
- [Give your AI agent its own email identity](/docs/agent-onboarding): Two-way email infrastructure for AI agents. Create aliases, send and receive email.

- **API reference**
- API
  - [A code-backed overview of the Bavimail API surface](/docs/api): This page mirrors the checked-in backend route groups, supported auth modes, and the route areas that are internal-only or debug-only.
  - [API Reference](/docs/api/reference): Interactive API reference for the Bavimail email API. Try endpoints, explore schemas, and test with your API key.
- [Every error code with what to do about it](/docs/errors): JSON error responses with descriptive messages and standard HTTP status codes.

- **Guides**
- [Verify your domain for production email delivery](/docs/domains): Configure DNS records for SPF, DKIM, and DMARC with step-by-step guidance.
- [Receive email and route it to your application](/docs/inbound): Parse messages, download attachments, and route inbound traffic via API and webhooks.
- [Signed webhook deliveries backed by the real event model](/docs/webhooks): Bavimail emits outbound lifecycle events, inbound receipt events, domain verification events, and test pings. Verification should match the actual SDK helper and header contract.
- [Official SDKs with language-specific capability differences](/docs/sdks): The SDKs do not expose identical surfaces. This page shows the real package names, constructors, auth modes, webhook helpers, and resource coverage for each maintained client.
- Integrations
  - [Use Bavimail with LangChain, CrewAI, LlamaIndex, Vercel AI SDK, Claude Code, Cursor, Cline, and n8n](/docs/integrations/ai-frameworks): Bavimail ships @bavimail/toolkit (npm) and bavimail-toolkit (PyPI) with first-party framework adapters, plus a separate @bavimail/mcp-server for MCP-compatible hosts. Every common AI agent workflow integrates through one of these packages.
- [Drive Bavimail from your AI assistant](/docs/mcp): MCP server for Bavimail. Claude Desktop, Cursor, Cline, and any MCP-compatible host can send email, manage domains, and handle inbound, all from the conversation.
- [Changelog](/docs/changelog): All notable changes to the Bavimail API, SDKs, and documentation.

# Compare

- [Compare Bavimail](/compare): Compare email providers across pricing, inbound email, domain tooling, and production workflows.
- [Bavimail vs AgentMail](/compare/agentmail): Compare Bavimail vs AgentMail for AI agent email infrastructure. Same two-way email capabilities with more included email volume at a lower entry price.
- [Bavimail vs Amazon SES](/compare/amazon-ses): Compare Bavimail vs Amazon SES across pricing, templates, dashboard, inbound, and total ownership cost for transactional email.
- [Cloudflare Email Sending Pricing (2026) vs Bavimail](/compare/cloudflare-email): Cloudflare Email Sending needs Workers Paid ($5 a month), includes 3,000 emails, then charges $0.35 per 1,000. Costs at 10K, 50K and 100K emails.
- [Bavimail vs Mailgun](/compare/mailgun): Compare Bavimail vs Mailgun across pricing, inbound email, deliverability, and operational tooling for transactional email.
- [Bavimail vs Postmark](/compare/postmark): Compare Bavimail vs Postmark across pricing, inbound email, deliverability tooling, and operational workflows for transactional email.
- [Bavimail vs Resend](/compare/resend): Compare Bavimail vs Resend across pricing, inbound email, domain tooling, webhooks, and operational workflows for developer email.
- [Bavimail vs SendGrid](/compare/sendgrid): Compare Bavimail vs SendGrid for developer email. Simpler pricing, faster onboarding, modern developer experience without enterprise-suite sprawl.

# Docs

- [Field notes from the Bavimail team](/blog): Short-form engineering writing on email APIs, deliverability, inbound parsing, and what changes when your sender is an AI agent rather than a human.
- [6 AgentMail Alternatives in 2026 (Pricing Compared)](/blog/agentmail-alternatives-2026): Compare 6 AgentMail alternatives by pricing, included email volume, inbound architecture, MCP support, and the agent workflow each platform fits best.
- [AgentMail Pricing (2026): Free, $20 Developer, $200 Startup](/blog/agentmail-pricing-review-2026): AgentMail costs $0 for 3 inboxes and 3,000 emails, $20 a month for 10 inboxes and 10,000 emails, $200 for 150 inboxes. Add-ons are $2 each.
- [AgentMail vs Bavimail](/blog/agentmail-vs-bavimail): AgentMail and Bavimail both ship first-party MCP servers, dedicated framework toolkit packages (@bavimail/toolkit + bavimail-toolkit on the Bavimail side, agentmail-toolkit on the AgentMail side), per-agent inbox primitives, and two-way email APIs for AI agents. Bavimail covers the same use case at one-quarter the monthly cost ($5/mo Developer vs $20/mo Developer at 10K emails), bundles transactional and marketing send on the same plan, and propagates an untrusted-third-party-content envelope on inbound tool responses for prompt-injection safety.
- [AgentMail vs Mailgun (2026): Pricing, Inbound, and AI-Agent Coverage](/blog/agentmail-vs-mailgun): AgentMail is the AI-agent inbox platform with native per-inbox storage and MCP-native inbound reads + replies. Mailgun is the high-volume developer transactional service with a deliverability suite and a first-party MCP server (v2.0.0, April 22 2026) that covers admin operations plus stored-message retrieval by key, but no inbox, thread, search, or reply toolset. Honest 2026 comparison of pricing (Mailgun Scale $90/mo for 100K with dedicated IP), inbound (webhook routes vs native inbox), and MCP tool coverage.
- [AgentMail vs Postmark (2026): Pricing, Inbound, and AI-Agent Coverage](/blog/agentmail-vs-postmark): AgentMail is the AI-agent inbox platform with native per-inbox storage and MCP-native inbound. Postmark is the developer transactional incumbent with 15+ years of deliverability reputation. Honest 2026 comparison of pricing (Postmark Pro is $16.50/mo for 10K), inbound (gated to Postmark Pro+ vs included on every AgentMail tier), webhook security (AgentMail signs, Postmark does not), and MCP server coverage.
- [AgentMail vs Resend (2026): Pricing, Free Plans and Inboxes](/blog/agentmail-vs-resend): Both free plans send 3,000 emails a month, 100 a day. For $20, Resend Pro sends 50,000 with 3 inboxes; AgentMail Developer sends 10,000 with 10 inboxes.
- [AgentMail vs SendGrid (2026): Pricing, Limits, and AI-Agent Support](/blog/agentmail-vs-sendgrid): AgentMail is an AI-agent inbox platform with a $20/mo developer tier and native MCP server. SendGrid is the high-volume transactional incumbent starting at $19.95/mo without a permanent free tier. Honest 2026 comparison of pricing, inbound, webhooks, and developer experience, with where each one wins.
- [AgentMail vs Amazon SES (2026): Pricing, Inbound, and MCP Coverage](/blog/agentmail-vs-ses): AgentMail is a managed per-agent inbox platform with production-ready MCP. Amazon SES is raw email infrastructure at $0.10 per 1,000 emails with a sample-only MCP server. Honest 2026 comparison: SES wins on per-email cost above 50K/mo, AgentMail wins on inbox primitives and webhook reliability. Includes realistic SES cost stack (base + dedicated IP + VDM) and the 2024 free-tier change you may have missed.
- [Amazon SES Pricing in 2026: Essentials vs A La Carte Costs](/blog/amazon-ses-pricing-2026): Compare Amazon SES Essentials at $0.16 per 1,000 emails with $0.10 a-la-carte pricing, plus dedicated IP, attachment, and inbound costs.
- [Bavimail launches on Product Hunt for Vercel Day 2026](/blog/bavimail-product-hunt-vercel-day-launch): Bavimail launches on Product Hunt for Vercel Day 2026. One email API for transactional sends, signed-webhook inbound, and per-agent inboxes for AI. Free for 3 months on Pro for PH users.
- [Bavimail vs Brevo (2026): Pricing, Multi-Channel, MCP, Honest Tradeoffs](/blog/bavimail-vs-brevo): Bavimail vs Brevo (formerly Sendinblue) head-to-head as of May 2026. Bavimail Developer $5/mo for full-stack email send + inbound + 12-tool MCP with prompt-injection wrapper + HMAC-SHA256 signed webhooks. Brevo: multi-channel marketing/transactional platform (email + SMS + WhatsApp + push + CRM) with a 193-tool MCP server auto-generated from their OpenAPI spec, 14+ years deliverability infra since 2007, but no cryptographic webhook signing (IP allowlist + basic auth + bearer token + custom headers, none cryptographic). Bavimail wins on transactional-only purpose-built tier, HMAC-signed webhooks, prompt-injection wrapper. Brevo wins on multi-channel breadth, CRM depth, 193-tool MCP surface.
- [Bavimail vs Mailtrap (2026): Sandbox vs Send-and-Receive, Honest Tradeoffs](/blog/bavimail-vs-mailtrap): Bavimail vs Mailtrap head-to-head as of May 2026. Bavimail Developer $5/mo (or $48/yr, $4/mo equivalent) (50K, full-stack send + inbound + 12-tool MCP with prompt-injection wrapper, per-alias inbox primitive) vs Mailtrap Email Sending Basic $15/mo (10K, send-focused) plus Email Testing sandbox ($14/mo+ for paid sandbox tiers, 50/mo free). Bavimail wins on price ($10/mo lower at 10K), first-class inbound webhooks, prompt-injection wrapper. Mailtrap wins on sandbox-testing primitive for development workflows and 24-tool MCP per docs.mailtrap.io. Includes pricing math, feature matrix, 5 FAQs.
- [Email APIs for AI Agents Compared (2026): Inboxes, MCP and Prices](/blog/best-email-api-for-ai-agents-2026): 7 email APIs for AI agents compared on per-agent inboxes, MCP servers, inbound payloads, prompt-injection safeguards and prices checked Oct 15, 2026.
- [Email APIs for Developers Compared (2026): 8 Providers and Prices](/blog/best-email-apis-for-developers-2026): Free plans and entry prices of 8 email APIs: Amazon SES $0.10/1K, Bavimail $5 for 50K, Mailgun, Mailtrap and Postmark $15 for 10K, Resend $20 for 50K.
- [Best Postmark Alternatives in 2026: 6 Email APIs Compared](/blog/best-postmark-alternatives-2026): Six honest Postmark alternatives compared with current pricing as of May 2026. Bavimail ($5/mo Developer for full-stack send + inbound + 12-tool MCP), Resend ($20 Pro 50K with React Email + April 2026 MCP), Twilio SendGrid ($19.95 Essentials, dedicated IPs at Pro), Mailgun ($15-$90 with Optimize suite), Amazon SES ($0.10/1K), AgentMail ($20/mo Developer with create_inbox primitive). Acknowledges what Postmark wins (98%+ inbox placement, Message Streams isolation, 15+ years deliverability reputation) so readers pick the right swap.
- [Best Resend Alternatives 2026 (Cheaper + Inbound-Capable)](/blog/best-resend-alternatives-2026): Compare 6 Resend alternatives with lower entry prices, stronger inbound workflows, per-agent inboxes, current 2026 pricing, and honest tradeoffs.
- [Best SendGrid Alternatives in 2026: 6 Email APIs Compared](/blog/best-sendgrid-alternatives-2026): Six honest SendGrid alternatives after Twilio killed the permanent free tier on May 27 2025. Bavimail ($5/mo Developer for full-stack send + inbound + 12-tool MCP), Resend ($20 Pro 50K + React Email + April 2026 MCP), Postmark ($16.50/mo Pro with August 2025 restructure + top deliverability), Mailgun ($15-$90 + Optimize suite), Amazon SES ($0.10/1K), AgentMail ($20/mo Developer + create_inbox primitive). Acknowledges what SendGrid still wins (Essentials 50K at $19.95 and Pro 100K at $89.95 with 1 dedicated IP managed warmup, 15+ years deliverability infra, subuser isolation) so readers pick the right swap.
- [Email API for AI Agents: 7 Platforms Compared (2026)](/blog/email-api-for-ai-agents-comparison-2026): Seven email APIs scored against the four criteria that actually matter for AI agent workflows: MCP server quality, webhook payload completeness, per-agent inbox primitive, and prompt-injection safety. Covers Bavimail (12-tool MCP with untrusted-third-party-content wrapper, $5/mo Developer), AgentMail (17-tool MCP with first-class create_inbox, $20/mo Developer), Resend (10 tool groups, metadata-only inbound webhook), Postmark (4 outbound-only Labs MCP), Twilio SendGrid (official MCP is docs-search only, not for sending email), Mailgun (50+ MCP operations, store-route inbound), Amazon SES (sample MCP not for production). Primary-source verified May 2026.
- [Email MCP server for Claude, Cursor, and Cline (2026)](/blog/email-mcp-server-for-claude-cursor-cline): A walkthrough of Bavimail's MCP server (v1.0, 12 tools) including setup for Claude Desktop, Cursor, and Cline, plus the prompt-injection-safe inbound-content wrapper.
- [How to give an AI agent its own email inbox](/blog/how-to-give-an-ai-agent-its-own-email-inbox): What an AI agent needs from an email inbox (persistence, two-way send and receive, programmatic provisioning) and how to wire one up in under 5 minutes with Bavimail.
- [Inbound email webhook tutorial: Node and Python (2026)](/blog/inbound-email-webhook-tutorial-node-and-python): A working tutorial for receiving and parsing inbound email via webhook in Node and Python. Covers signature verification, attachment handling, and reply threading.
- [LinkedIn automation limits: the daily and weekly caps our engine enforces](/blog/linkedin-automation-limits): LinkedIn doesn't publish its limits. These are the caps Bavlio's outreach engine enforces on each connected LinkedIn account.
- [Mailgun Pricing 2026: Plans, Overages, and What You Actually Pay](/blog/mailgun-pricing-2026): Mailgun Send pricing explained: Free, Basic, Foundation, and Scale allowances, overages, validation, dedicated IPs, and worked 10K, 50K, and 200K examples.
- [Send email with Next.js](/blog/send-email-with-nextjs): Install the bavimail package, add a Next.js route handler that emails the signed-in user, then check delivery. Code tested against the live API on Oct 15, 2026.
- [Send email with Node.js and Express](/blog/send-email-with-nodejs): Install the bavimail package, add an Express route that emails the signed-in user, then check delivery and read replies. Code tested against the live API on Oct 15, 2026.
- [Send email with Python](/blog/send-email-with-python): Install the bavimail package, set your API key and send an email with client.emails.send(). Then check delivery and read replies. Tested against the live Bavimail API on October 14, 2026.
- [SPF, DKIM, DMARC setup for transactional email (2026 guide)](/blog/spf-dkim-dmarc-setup-guide-2026): The 2026 setup guide for SPF, DKIM, DMARC, and MAIL FROM on a transactional sending domain. Includes the Gmail and Yahoo bulk-sender enforcement timeline and a programmatic verification path.
- [Transactional Email API Comparison 2026: Prices for 7 Providers](/blog/transactional-email-api-comparison-2026): Free plans and entry prices of 7 transactional email APIs: Amazon SES $0.10/1K, Bavimail $5 for 50K, Mailgun and Postmark $15 for 10K, Resend $20 for 50K.

# Docs

- [The product surface behind Bavimail's developer-email positioning](/feature): Bavimail is not just a send endpoint. The public product story includes outbound, inbound, webhooks, domains, analytics, suppressions, and operational feedback.
- [Let your AI agent sign up and run LinkedIn outreach (2026)](/feature/ai-agent-linkedin-outreach): How an AI agent registers a Bavlio account, builds a LinkedIn campaign, connects your account, runs the sequence and answers replies, and the three steps left to you.
- [SPF, DKIM, DMARC, and MAIL FROM guidance where developers actually need it](/feature/domain-verification): Domain setup is one of the highest-friction parts of email infrastructure. Bavimail makes it part of the product, not a side quest hidden in support docs.
- [Keep delivery state close to your application with signed event webhooks](/feature/email-webhooks): Bavimail webhooks help teams update internal state fast when messages are delivered, opened, clicked, bounced, or suppressed.
- [Inbound email API: receive, parse, and route email programmatically](/feature/inbound-email): Bavimail's inbound surface is designed for apps that need to receive messages, parse content, capture attachments, and route the result into business logic.
- [Inboxes for AI agents](/feature/inboxes-for-ai-agents): Give an AI agent an inbox on each channel that it can send from and read replies on.
- [LinkedIn API for AI agents](/feature/linkedin-api): What LinkedIn's Messages and Invitations APIs allow, and how an AI agent sends connection requests and messages and reads the inbox through a REST API or an MCP server instead.
- [LinkedIn MCP server for Claude Code and Cursor](/feature/linkedin-mcp-server): A hosted MCP server where an AI agent registers its own account, builds a LinkedIn campaign, connects your account, runs the sequence and answers replies.
- [Transactional email API for developers, free for 6,000 emails a month](/feature/transactional-email-api): Send password resets, receipts and alerts from your app with one API call. Free for 6,000 emails a month with no card, then $5 a month for 50,000. TypeScript and Python SDKs, signed webhooks, and inbound email on the same domain.

# Docs

- [Bavimail for every builder](/audience): Explore email infrastructure for founders, developers, and AI agents.
- [Email API for AI agents: give every agent its own inbox](/audience/ai-agents): Send outbound email, receive inbound email on signed webhooks, and verify domains programmatically, all through a single REST API. No IMAP polling, no mail parsing library, no shared inbox. Each agent gets a dedicated address, isolated reputation, and scoped API key.
- [A clean email API. Most teams send their first email in under 5 minutes.](/audience/developers): TypeScript and Python SDKs with full OpenAPI coverage. Send transactional email, receive inbound mail on a webhook, verify domains programmatically. No dashboard-only workflows: every capability is available via the API.
- [Email infrastructure that grows with your startup](/audience/founders): Most teams ship their first transactional email in under five minutes with a free tier that covers 6,000 emails per month. No credit card, no infrastructure to manage, no warm-up program. When you grow, the Developer plan is $5/month for 50,000 emails.

## Pricing

- [Pricing](https://bavimail.com/pricing): current plans, allowances and billing options from the live catalog.