The Email resource library
Email guides and resources.
Go step by step from your first send to migrating off your current provider.
Trusted by engineering and product teams shipping at global scale.
Choose the right email workflow
Pick the integration path for transactional sends, marketing broadcasts, inbound routing, or AI agent mailboxes.
- Send your first emailVerify your domain, create an API key, and send a test email in minutes.
- Create campaignsImport contacts, build audiences, and schedule broadcasts with your team.
- Send from your applicationTrigger password resets, receipts, and account alerts over the HTTP API.
- Connect an SMTP applicationRoute mail from existing apps by updating your SMTP host and credentials.
- Receive email in your applicationForward customer replies and attachments directly to your webhook endpoint.
- Give an agent an inboxProvision mailboxes so AI agents can read threads, filter spam, and reply.
Email, explained
Choose the right protocol, message stream, and architecture before writing code.
- Transactional or marketing email?Separate receipts from promotional mail to protect your sender reputation.
- What is an email API?Send templated emails from code and track delivery and bounces via webhooks.
- SMTP and IMAPSee how SMTP relays outbound mail and how IMAP syncs inboxes across clients.
- Explore Email explainedRead guides on email protocols, message headers, webhooks, and architecture.
Prepare a campaign with your team or an agent
Manage contacts, reusable templates, and scheduled broadcasts from the dashboard, API, CLI, or MCP.
- Import and sync contactsUpload CSVs or sync subscribers via API with custom fields for targeting.
- Build a reusable audienceGroup contacts into recipient lists and verify counts before scheduling.
- Author and preview a templateDraft HTML and plain-text templates with variables and language variants.
- Create a broadcastPick an audience and template, schedule your send, and track engagement.
- Connect your AI agentConnect the Bird CLI or MCP server so your agent can manage email workflows.
- Give the agent the right instructionsInstall Bird skills so your coding agent follows verified API and CLI patterns.
Build and test the integration
Send single or batch messages, test failure paths in a sandbox, and handle webhook events.
- Send your first emailCreate an API key, send a message with curl or an SDK, and inspect the log.
- Test delivery outcomesSend to sandbox addresses to simulate deliveries, bounces, and complaints.
- Schedule a messageQueue transactional emails for a future time or cancel pending sends early.
- Send a batchSend personalized messages to multiple recipients in a single API request.
- Receive and parse emailConfigure an inbound domain to receive parsed bodies, headers, and files.
- React to eventsHandle webhooks for deliveries, bounces, complaints, opens, and clicks.
Understand and improve deliverability
Authenticate your sending domain, meet mailbox provider requirements, and keep messages out of spam.
- Delivery versus inbox placementDistinguish server acceptance from inbox placement to spot spam filtering.
- SPF, DKIM and DMARCAuthenticate your sending domain with SPF, DKIM, and DMARC to build trust.
- One-click unsubscribeAdd RFC 8058 list-unsubscribe headers to meet Gmail and Yahoo bulk rules.
- Explore Deliverability explainedSee how IP warming, domain reputation, and bounce handling protect inboxing.
- Measure your inbox placementTrack inbox versus spam placement across providers and run seed list tests.
- Research competitor campaignsMonitor competitor domains to compare send volume, subjects, and read rates.
Investigate a sending problem
Trace missing messages, decode SMTP bounce errors, and inspect suppressed or unsubscribed addresses.
- Inspect the email logSearch by recipient or message ID to trace deliveries, bounces, and clicks.
- Understand a bounceDecode SMTP bounce codes to fix invalid addresses, full inboxes, or blocks.
- Understand a rejected recipientCheck if an address was blocked by a prior hard bounce or spam complaint.
- Understand an opt-outConfigure unsubscribe links and verify how opt-outs stop marketing sends.
- Interpret campaign metricsAccount for Apple Mail Privacy Protection and proxy opens in your reports.
- Check an addressValidate syntax, MX records, and disposable domains before sending mail.
Move your email to Bird
Migrate sending domains, suppression lists, templates, and webhooks from your existing provider without dropping mail.
- Plan the migrationVerify DNS alongside your current provider and shift traffic incrementally.
- From SendGridMap v3 Mail Send payloads, import suppressions, and switch Event Webhooks.
- From Amazon SESReplace SES send calls and SNS notifications with Bird APIs and webhooks.
- From MailgunMove multipart or JSON send requests, suppressions, and webhook endpoints.
- From ResendUpdate your send endpoint, verify domains, and connect delivery webhooks.
- Compare providersCompare capabilities, pricing, and migration paths across email providers.
Learn by doing
Watch step-by-step video walkthroughs or diagnose authentication and DNS issues with free browser tools.
- Build an email broadcastWatch how to pick an audience, schedule a broadcast, and review metrics.
- Build an email templateSee how to create, personalize, and preview a reusable email template.
- Analyze email headersPaste raw headers to inspect SPF, DKIM, and DMARC verdicts and hop delays.
- Read a DMARC reportUpload XML reports to spot unauthorized senders and alignment failures.
- Prepare a DMARC policyGenerate a valid DMARC TXT record with your policy and reporting addresses.
- Format a long DNS recordSplit long DKIM keys and TXT values into 255-character DNS record chunks.
Start sending and receiving email with Bird.
Create a workspace, verify your sending domain, and deliver your first transactional email or marketing broadcast in minutes.