Email deliverability

Understand and improve your email deliverability.

Manage the factors your team can influence: domain authentication, sending reputation, suppression and delivery monitoring. Bird gives you the controls and signals to investigate problems. For placement estimates on your verified sending domains, explore Inbox Insights.

Open the analyzer and paste the headers from a message to inspect its authentication and routing.

Set up in:
Cursor

Follow a message

Delivery signals

01

Authenticate the sender

DKIM · SPF · DMARC
02

Check the recipient

Preferences and suppressions

03

Read the delivery response

Accepted, deferred or bounced

A separate measurement

Did it reach the inbox?

Investigate placement with Inbox Insights and seed tests.

Workflow illustration. Recipient mail servers determine placement; a delivered event records acceptance.

Looking for inbox placement monitoring?

Delivery events tell you whether a recipient server accepted a message. Inbox placement is a separate question. Use Inbox Insights to investigate inbox versus spam placement for your verified domains and test a campaign with seed addresses.

Explore Inbox Insights

Deliverability is a feature, not a hope.

The Bird Email API combines domain authentication, managed warmup for dedicated IPs, recipient suppressions and sending metrics. Your team still controls consent, content and audience quality. Use the appropriate signal for the question: sending events for delivery and Inbox Insights for estimated placement.

Five things working for you on every send.

Domain setup, sending controls and delivery feedback work together.

  1. 01

    Authenticated sending.

    Verify your sending domain and publish its authentication records. DKIM signs messages, SPF identifies authorized sending infrastructure, and a DMARC policy tells receivers how to handle authentication failures.

  2. 02

    Managed IP warmup.

    Start on a shared pool, or take dedicated IPs that Bird warms automatically over roughly 30 days and organizes into pools you control.

  3. 03

    Automatic suppression.

    Hard bounces block delivery to an address; complaints block non-transactional mail. Unsubscribe preferences are stored separately and checked when processing a send.

  4. 04

    Message-level diagnosis.

    Inspect a recipient’s event timeline and receiving-server response in the email log. Use that response to identify the next configuration or sending change to investigate.

  5. 05

    Per-provider visibility.

    Bounce codes, complaint types, and mailbox-provider and client breakdowns, broken out per domain, ISP, and IP, in the dashboard and via the stats API.

You don't write deliverability. You watch it.

Configure your domain authentication, IP warmup and suppression workflow, then review the sending results. Pull bounce and complaint rates, mailbox-provider breakdowns and bounce codes from the stats API to investigate a changing trend.

reputation.ts
200
// Watch the rates that decide whether you reach the inbox.
const { data, error } = await bird.email.stats.summary({
  from: "2026-06-01",
  to:   "2026-06-23",
}).safe();
if (error) throw error;

console.log(data.delivery.bounce_rate);    // 0.004
console.log(data.delivery.complaint_rate); // 0.0006
console.log(data.delivery.delivered);      // 248119

What healthy sending looks like.

The Metrics dashboard classifies delivery, bounce and complaint signals as Healthy, Watching or Throttled. Those labels describe risk; they do not automatically change your sending rate or pause mail. Investigate the affected domain, provider or audience and pause a campaign yourself when its source data needs attention.

Go deeper in the docs.

Set up authentication with the DKIM, SPF & DMARC guide, plan a ramp with the IP warmup guide, or read the full deliverability guide for the playbook end to end.

Questions about deliverability

What can Bird help me control?
Bird provides domain authentication, dedicated IP pools with managed warmup, recipient suppressions, preferences and sending metrics. Your team controls consent, content and sending behavior. Inbox Insights measures placement separately.
How do I investigate a decline?
Use the stats API and dashboard to review bounce reasons, complaints, sending domains and mailbox-provider breakdowns. Inspect a specific recipient in the email log. Use Inbox Insights to investigate placement estimates and run campaign seed tests.
Do health classifications automatically pause sending?
No. Healthy, Watching and Throttled classify sending risk. They do not change your sending rate or pause traffic. Investigate the affected campaign or list and decide whether to pause it.
What happens after a bounce, complaint or unsubscribe?
Hard bounces create a suppression that blocks mail to the address. Complaints block non-transactional mail. Unsubscribes record a preference separately. Transactional delivery still depends on the address being valid and on any other blocking records.

Make your next delivery issue easier to investigate.

Review your authentication, sending reputation and delivery signals, or discuss placement monitoring with an email specialist.

Start with one channel.
Add the others when you're ready.

A test API key is yours immediately. Production unlocks when you add a payment method and verify a sender.

Using Claude Code, Cursor, or Codex? Copy a setup prompt and your agent installs the Bird CLI and skills for you. Pick yours:

Cursor