Send email from one API.
Send receipts and campaigns from the same integration, with retry protection against duplicate emails.
Already sending through SMTP?
Point your existing mailer or framework at Bird’s SMTP relay by swapping credentials without rewriting your application code. When your product also needs to route customer replies, support threads, or attachments back into your app, pair outbound sending with inbound email.
Send your first email in five minutes.
Test delivery before you configure DNS.
Build outbound email into your app with the Bird Email API using our SDKs, REST endpoint, CLI, or MCP. You can send your first test message to a built-in sandbox address right away, letting you verify webhook handling and bounce behavior in local development before you configure DNS records for your domain.
// Install the SDK
// npm install @messagebird/sdk
const msg = await bird.email.send({
from: { email: "onboarding@messagebird.dev", name: "Bird" },
to: ["delivered@messagebird.dev"],
subject: "Hello from Bird",
html: "<p>My first Bird email.</p>",
});
console.log(msg.id, msg.status); // "em_…", "accepted"Built-in safeguards for production email.
Ship reliable email delivery without building retry locks, bounce lists, or template pipelines from scratch.
01Separate transactional and marketing rules.
Send password resets and promotional campaigns through one integration. Bird automatically enforces unsubscribe preferences on marketing mail and still delivers critical account alerts and receipts to your users.02Templates, attachments, and scheduled sends.
Render React Email components in your codebase, pass raw HTML directly, or populate stored templates with dynamic recipient data at send time. Attach PDFs or inline images and schedule future deliveries up to 30 days ahead without running your own cron queue.03Atomic batch sending for up to 100 messages.
Trigger up to 100 personalized emails in a single API call, each with its own recipient and template variables. Bird validates the entire batch upfront so a malformed entry rejects the request cleanly instead of leaving a partial send.04Safe network retries without duplicate emails.
Network timeouts happen in production. Attach a unique request key when your worker sends an email so automatic retries return the original send status instead of emailing your customer twice.05Signed webhooks for real-time delivery tracking.
Follow each message from server acceptance and inbox delivery to opens, link clicks, bounces, and spam complaints. Signed, replay-protected webhooks use the same event format across Bird Email, SMS, WhatsApp, and Voice.
Make the first request from your application.
Create an account and API key, then follow the sending guide with a test recipient.
Migrate from your current email provider in an afternoon.
Keep your existing HTML or React Email templates and swap the send call in a few lines of code. Step-by-step migration guides walk you through moving domains, webhooks, and suppression lists from SendGrid, Amazon SES, Mailgun, and Resend.
import sgMail from "@sendgrid/mail";
sgMail.setApiKey(process.env.SENDGRID_API_KEY!);
await sgMail.send({
from: "hello@yourdomain.com",
to: "delivered@messagebird.dev",
subject: "Your invite is ready",
html: "<p>Welcome aboard, Ada.</p>",
});
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
await bird.email.send({
from: "hello@yourdomain.com",
to: ["delivered@messagebird.dev"],
subject: "Your invite is ready",
html: "<p>Welcome aboard, Ada.</p>",
});
Send up to 100 personalized emails in a single request.
Whether you are sending weekly product digests, billing reminders, or team notifications, you can batch up to 100 independent emails in one API call with per-recipient personalization. Bird validates the entire batch before accepting it, so an invalid message rejects the request cleanly instead of leaving a partial send that is hard to recover from.
import { BirdClient } from "@messagebird/sdk";
import { render } from "@react-email/render";
import { Digest } from "./emails/digest";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
const messages = await Promise.all(
users.map(async (u) => ({
from: "Acme <hello@yourdomain.com>",
to: [u.email],
subject: "Your weekly digest",
html: await render(<Digest user={u} />),
})),
);
const { data: batch, error } = await bird.email
.sendBatch(messages)
.safe();
if (error) throw error;
console.log(`queued ${batch.data.length} messages`);
Correlate deliveries with your own database records and campaigns.
Label emails with up to 20 tags to break down delivery, open, and bounce rates by feature, onboarding flow, or campaign. You can also attach up to 2 KB of custom metadata such as an order ID, invoice number, or user ID, which returns unchanged on API reads and webhook events so your backend can match status updates without maintaining a lookup table.
await bird.email.send({
from: "Acme <hello@yourdomain.com>",
to: ["delivered@messagebird.dev"],
subject: "Your invite is ready",
html: "<p>Welcome aboard, Ada.</p>",
tags: [{ name: "campaign", value: "spring-2026" }],
metadata: { user_id: "u_2bX91", order_id: "ord_5512" },
});
Track delivery, bounces, and engagement in real time.
Know when a customer’s mail server accepts an email, when a mailbox is temporarily full, or why an address bounced. Verify a single webhook signature and handle events using the same payload structure across Email, SMS, Voice, and WhatsApp.
Hard bounces and spam complaints automatically add the recipient to your suppression list, and unsubscribes record an opt-out preference so future sends respect recipient choices automatically.
email.accepted- Bird accepted your send request and queued the message for processing.
email.processed- The message is rendered and ready for handoff to the recipient’s mail server.
email.delivered- The recipient’s mail server accepted the message for delivery.
email.deferred- The receiving server temporarily delayed acceptance; Bird automatically retries delivery.
email.bounced- Delivery failed permanently, with the bounce classification and diagnostic reason included.
email.opened- The recipient opened the email and loaded the tracking pixel.
email.clicked- The recipient clicked a tracked link in the email body.
email.complained- The recipient marked the email as spam in their mailbox.
email.unsubscribed- The recipient opted out via a tracked unsubscribe link or header.
import { bird } from "@/lib/bird";
export async function POST(req: Request) {
const event = bird.webhooks.unwrap(
await req.text(),
Object.fromEntries(req.headers),
);
switch (event.type) {
case "email.delivered":
await markDelivered(event.data.email_id);
break;
case "email.bounced":
await flag(event.data.recipient, event.data.bounce_type);
break;
}
return new Response(null, { status: 204 });
}
Test bounces, deferrals, and complaints safely before launch.
Use Bird’s built-in sandbox addresses to simulate successful deliveries, hard bounces, soft bounces, temporary deferrals, spam complaints, and suppressed recipients without emailing real customers or risking your sender reputation. Each test send runs through the real event pipeline and triggers signed webhooks to your local or staging server. When you are ready for production, verify your sending domain and let managed warmup ramp traffic safely.
Explore the developer guides.
Follow the email sending guide to send HTML, templates, and attachments from your backend, configure delivery events and webhooks to sync message status with your database, or use a provider migration guide to switch from SendGrid, Amazon SES, Mailgun, or Resend.
Build the workflows around outbound email.
Once your application can send its first email, you can schedule future deliveries up to 30 days ahead, cancel queued messages before they go out, attach files or inline images, and rehearse bounce handling in staging.
Continue with the workflow you need
Guides and resources for testing, scheduling, and scaling your email integration.
- Email sandboxSimulate deliveries, bounces, deferrals, and spam complaints safely in staging.
- Scheduled messagesQueue emails up to 30 days in advance and cancel pending sends when plans change.
- Batch sendingSend up to 100 personalized emails in one atomic API request.
- Email integration libraryBrowse setup, provider migration, and deliverability troubleshooting guides.
When the right home appears, the email needs to arrive.
Zillow brought time-sensitive property alerts to Bird, with the capacity to handle sending surges and the analytics to understand engagement. Its team reported a 161% increase in open rates in the first month.
Planning a migration or a higher-volume send?
Contact Sales161%
Increase in email open rates reported in Zillow’s customer story.
Questions about sending email
Can I send both transactional and marketing email?
What happens if a request times out and I retry it?
Can I schedule a send for later?
Can I attach files?
Connect sending to the rest of your workflow
- TemplatesManage versioned email templates that product teams can edit and personalize at send time.
- DeliverabilityProtect inbox placement with domain authentication, managed IP warmup, and automatic bounce suppression.
- AnalyticsMonitor delivery, bounce reasons, and recipient engagement across mailbox providers and domains.
- Email API overviewDeliver transactional emails, run marketing campaigns, and handle replies from one platform.
Scale without losing control.
Separate production and sandbox traffic into dedicated workspaces, scope API keys to the exact channels each service or agent needs, and track permission changes in the audit log.
Talk to our email team
Build your next email integration.
Talk through transactional messages, batch sends and delivery events. We’ll help you plan your integration, sending volume and migration.
Create your account, then create an API key and send a test message.