# Email for developers

From the first welcome to the next big launch. Send and receive email with Bird’s API.

[Get started](/dashboard/signup?returnTo=%2Fdashboard%2Fw%2Femail)

[Contact Sales](/demo?product=email)

[Read customer stories](/customers)

[Explore Enterprise](/enterprise)

- [Airwallex](/customers/airwallex)
- [Glovo](/customers/glovo)
- [Zillow](/customers/zillow)
- Uber
- [Binance](/customers/binance)
- Adobe
- Meta
- PayPal
- Pinterest
- Square
- [Al Jazeera](/customers/aljazeera)
- [Aramex](/customers/aramex)
- [Bazaar Technologies](/customers/bazaar)
- [ComparaOnline](/customers/compara)
- [Emma](/customers/emma)

## From prompt to delivered.

Send email from your app or agent. Follow it through delivery. Full read and write access through MCP and CLI.

**MCP**: `Bird MCP`

```json
https://mcp.bird.com
```

## One template.  Made personal.

Publish once. Personalize each send with the details from your app.

Email Studio
CONTACT PROPERTY First name Preview contact

Hi {{ first_name }} ,

Apply to greeting Alex

harborObjects for everyday living.
THE EVERYDAY COLLECTION

### Good things.  Made for real life.

Hi Alex , meet the pieces that make ordinary moments feel a little more special.

Find your favorite

[Explore Email templates](/email-api/features/templates)

## A personal touch.  A wider reach.

Turn contact details into personal messages for the right audience.

MC

### Maya Chen

Contact

 maya@example.comEmail
+1 202 555 0142Phone

 First name Maya
 City Lisbon  Membership Plus

Audiences 1 selected
  Harbor members 420 contacts

 Email Personalized preview

HARBOR® MORE POSSIBILITIES. JUST FOR YOU.

### A little more room for you, Maya.

A little extra for Plus members. Make yourself at home.

Explore your benefits  The Harbor team

### Personalized broadcast

Ready for review

Audience
Harbor members420 recipients

Schedule
24 Sep, 09:00Email · UTC

 [Explore broadcasts](/docs/guides/email/broadcasts)

## Ready to send. From your domain.

Verify DKIM, return-path, and DMARC.  Manage reputation as your volume grows.

  Sending domain
 mail.harbor.example Ready to send
 DKIMTXT Ownership and signing  Verified
Return-pathCNAME SPF and bounce handling  Verified
DMARCTXT Authentication policy  Verified

 Sending enabled All three sending records verified.
 Branded tracking Optional

Illustrative verification states. DNS checks can take time to propagate. No domain is registered or verified from this page.

[Domain setup](/docs/guides/email/sending-domains)[DKIM, SPF & DMARC](/docs/guides/email/dkim-spf-dmarc)[Dedicated IPs](/docs/guides/email/dedicated-ips-and-pools)[Suppressions](/docs/guides/email/suppressions)
[Explore deliverability](/email-api/features/deliverability)

## Before you ship.  After you send.

Preview requests, follow delivery, and fix errors with clear feedback.

Email sandbox
To `delivered@messagebird.dev`
DeliveredBounced
01 `email.accepted`

02 `email.processed`

03 `email.delivered`

Email delivered Run test

### Test before you send.

Exercise delivered and bounced outcomes with sandbox recipients.

[Explore testing](/docs/guides/email/testing-sandbox)

`POST /webhooks/bird` Signed
Email delivered

Its signed event is ready for your endpoint.

 `email.delivered`14:32:01 · 38 ms  Queued

 `email.processed`14:32:01 · 38 ms  200

Endpoint response Replay event

### Know what happened.

Follow recipient delivery through signed events and endpoint replays.

[Explore webhooks](/docs/guides/email/events)

`POST /v1/email/messages`
Idempotency-Key `welcome/customer_42`
Original request 202 Accepted  `id: em_01ky7ma8y2es1s2akzk53tmjn0`status: accepted
Same request · retry 01 202 Accepted  `id: em_01ky7ma8y2es1s2akzk53tmjn0`Idempotency-Replay: true

Same request. Same result. Retry request

### Recover the response.

Retry with the same key to recover the original response.

[Explore idempotency](/docs/guides/idempotency)

`POST /v1/email/messages`
`to[0]` 422 `E01001 ValidationError`

`to[0]` must be a valid email address.  Separate the mailbox and domain with @.

`req_01ky7q4665emc9tw1pxkptaqwq`[Error reference](/docs/api/errors/E01001)

Fix & retry

### Errors you can act on.

The field, the reason, and the correction. Then try again.

[Explore errors](/docs/guides/errors)

Illustrative product states. No messages are sent from this page.

## Every email.  A clearer picture.

Follow delivery over time. See which providers account for bounces.

Email analytics

### Delivery over time

89,712 accepted  98.7% delivery rate

Accepted Delivered Bounced
Sep 21 · UTC

74.0%

of bounces in this hour   Gmail

321 of 434 · 14:00–15:00 UTC

#### By provider

14:00–15:00 UTC

Provider | Accepted | Bounced | Share |

Gmail | 3,670 | 321 | 74.0% |

Outlook | 2,002 | 78 | 18.0% |

Yahoo | 1,000 | 35 | 8.1% |

[Explore Email analytics](/email-api/features/analytics)

## Explore Email.

From sending domains to incoming replies. Build email into your app.

[Email API

Send email from your application. Follow the result for each recipient.](#integrate)[Templates

Create reusable emails that feel personal to each recipient.](/email-api/features/templates)[Deliverability

Prepare your sending identity and understand delivery health.](/email-api/features/deliverability)[Inbound

Receive email in your application, with the content and attachments ready to process.](/email-api/features/inbound)[Automations

Send the right email when an event occurs.](/docs/guides/automations)[Broadcasts

Personalize, schedule and track an email campaign.](/email-api/features/broadcasts)[Audiences

Build audiences from the contacts you want to reach.](/email-api/features/audiences)[SMTP

Connect email sending to the applications you already run.](/email-api/features/smtp)[Webhooks

Let your application react to email events.](/docs/guides/email/events)[Analytics

See where email succeeds and where to investigate.](/email-api/features/analytics)

## Scale without  losing control.

Organize teams in workspaces, control API access, and trace changes through audit logs.

Harbor Organization
Workspaces Production Sandbox

### Delivery agent

API key · Customer operations team
Active
Permissions Access
Email Read & write
SMS Read & write
WhatsApp Read Read & write
AL Alex Lee Admin  Permissions updated

### Audit log

Production
 API key updated Alex Lee · 09:42:18 UTC

Workspace
Production

Resource
Delivery agent

WhatsApp
Read Read & write

Succeeded

 [Workspaces](/docs/guides/workspaces)[Team roles](/docs/guides/users-teams-roles)[API authentication](/docs/guides/authentication)
[Explore Enterprise](/enterprise)

Examples: [MCP](/it-it/email-api.mcp.md) · [CLI](/it-it/email-api.cli.md) · [TypeScript](/it-it/email-api.ts.md) · [Python](/it-it/email-api.py.md) · [Go](/it-it/email-api.go.md) · [PHP](/it-it/email-api.php.md) · [cURL](/it-it/email-api.curl.md)

## Start with Email. Build across channels with Bird.

[Get started](/dashboard/signup?returnTo=%2Fdashboard%2Fw%2Femail) · [Contact Sales](/demo?product=email)

[Email](/email-api) · [SMS](/sms-api) · [WhatsApp](/whatsapp-api) · [Apple Messages](/apple-messages-api) · [Voice](/voice-api)



## Related resources

- [Getting started with email](/learn/email/getting-started-with-email) (video)
- [Send your first email](/docs/get-started/send-your-first-email) (docs)
- [Build your first integration](/learn/paths/integration) (course)

[Get an implementation brief](/learn/workspace?topic=email)
