# Bird

> Customer communication. Beautifully connected. Send and receive customer
> messages, run campaigns, and manage conversations around every booking,
> purchase, and support request.

## Choose your next step

- [Email API](https://bird.com/email-api): send application email and inspect acceptance, delivery, and webhook events.
- [Email platform](https://bird.com/email): choose a workflow for campaigns, replies, deliverability, or infrastructure.
- [All products](https://bird.com/products): messaging, voice, verification, and connectivity.
- [Campaign tools](https://bird.com/email-marketing): work with audiences, messages, and delivery results.
- [Bring your own AI](https://bird.com/ai): connect your agent to Bird's existing tools.
- [Customer stories](https://bird.com/customers): outcomes reported by Bird customers.

The homepage's campaign, booking, verification, connectivity, and workspace
walkthroughs use illustrative data. They do not send messages, access an account,
confirm a booking, or purchase a plan.

## Status (read this before generating code)

- **Email, SMS, WhatsApp**: generally available on the developer API, SDKs, CLI,
  and MCP today. WhatsApp covers sending templates and free-form content, reading
  messages and their event timelines, inbound media, and webhooks; templates,
  numbers and aggregate stats are dashboard-only.
- **Voice**: live on the Bird platform; the new unified developer API is rolling
  out. Check the channel's docs for current API status before integrating.
- **Inbound (receive)**: available; coverage varies by channel. Confirm in the channel docs.
- Always treat the live MCP tool list and the OpenAPI spec as the authoritative
  inventory, not this file.

## Start here

- [Quickstart](https://bird.com/docs/get-started/send-your-first-email/): set up an API key and send your first test email
- Install the CLI: `curl 'https://cli.bird.com/install.sh' | sh`
- Connect the hosted MCP: `claude mcp add --transport http bird https://mcp.bird.com`,
  then authenticate it (OAuth-gated, tools fail without a grant): in Claude Code run
  `/mcp`, select `bird`, choose Authenticate; headless, `claude mcp login bird`.
  Other hosts: https://bird.com/docs/ai/mcp-server#connect-a-client

## For AI agents

- [MCP server](https://bird.com/docs/ai/mcp-server): Hosted at mcp.bird.com. Credential-less OAuth, scoped per workspace, curated task-level tools, destructive operations annotated
- [Agent skills (bird-ai plugin)](https://bird.com/docs/ai/agent-skills): Skills + MCP, installed in one step
- [CLI for agents](https://bird.com/docs/ai/cli-for-agents): JSON output, semantic exit codes, fewer tokens per operation
- [llms-full.txt](https://bird.com/llms-full.txt): Full machine-readable docs corpus

## Machine-readable surfaces

- [OpenAPI 3.1 spec](https://bird.com/openapi.json): every public endpoint, schema, and error code. Same file as [/openapi.yaml](https://bird.com/openapi.yaml), and the file the SDKs are generated from
- [OAuth 2.0 authorization server metadata](https://platform.bird.com/.well-known/oauth-authorization-server): RFC 8414 discovery, at the issuer itself. Authorization, token, device, revocation, and dynamic client registration endpoints, plus every delegable scope
- [Sitemap](https://bird.com/sitemap.xml): every page, per locale
- [auth.md](https://bird.com/auth.md): how an agent obtains, uses, and revokes a credential, in prose
- Any page as Markdown: append `.md` to its URL, or send `Accept: text/markdown`
- Code examples: TypeScript/JavaScript, Python, Go and PHP SDKs; Swift and Kotlin Realtime clients; and CLI, cURL, MCP or shell examples, wherever offered. Follow a Markdown page's `Examples:` links for focused language views such as `.py.md`; the links list the alternatives that page offers.
- To select examples within the full page, send `Accept-Language: en-us, python` to choose a named example. Matching examples change in place; other examples and content remain. A preference with no matching example keeps the default. The page URL selects the content locale.

## Learn and practise

- [Topic and resource catalog](https://bird.com/content-map.json): Versioned relationships between current products, docs, answers, tools, videos and practice briefs

- [Learning paths](https://bird.com/learn/paths.md): guided courses with existing Bird login for saved progress and assessments
- [Video and transcript catalog](https://bird.com/learn/library.md): every published guide, its video, transcript and current implementation resources
- [Search learning](https://bird.com/learn/library.md?q=whatsapp+template): scoped title, description and transcript search; accepts `q` and `channel`
- [Practice and implementation handoff](https://bird.com/learn/workspace): browser simulations and task-specific coding briefs; use current docs for API contracts
- [Course certificates](https://bird.com/learn/certifications.md): completion requirements and private account records

## Developers

- [API reference (Markdown)](https://bird.com/docs/api.md)
- [SDKs (Markdown)](https://bird.com/docs/sdks.md): TypeScript/JavaScript, Python, Go and PHP; Swift and Kotlin for Realtime
- [CLI (Markdown)](https://bird.com/docs/cli.md)
- [The contract](https://bird.com/docs/guides/): Auth, idempotency, errors, webhooks, pagination, rate limits. Identical across channels
- [Changelog](https://bird.com/changelog) · [Status](https://bird.com/status)

## Products

Per-channel product pages, as Markdown (append `.md` to any page URL for the raw source):

- [Email API](https://bird.com/email-api.md)
- [SMS API](https://bird.com/sms-api.md)
- [WhatsApp](https://bird.com/whatsapp-api.md)
- [Apple Messages](https://bird.com/apple-messages-for-business.md)
- [Agent mailboxes](https://bird.com/agent-mailboxes.md)
- [PowerMTA](https://bird.com/powermta.md)
- [Voice](https://bird.com/voice.md)
- [RCS](https://bird.com/rcs-business-messaging.md)
- [Push](https://bird.com/push-notifications.md)
- [Verify](https://bird.com/verification-api.md)
- [Lookup](https://bird.com/phone-number-lookup-api.md)
- [eSIM](https://bird.com/esim-api.md)
- [Realtime](https://bird.com/realtime-messaging-api.md)
- [All products](https://bird.com/products.md) · [Channels](https://bird.com/channels.md) · [Pricing](https://bird.com/pricing.md)

## Solutions

Industry and use-case pages, as Markdown:

- [Banking (B2C)](https://bird.com/solutions/banking-b2c.md)
- [Fintech (B2B)](https://bird.com/solutions/fintech-b2b.md)
- [Fintech (B2C)](https://bird.com/solutions/fintech-b2c.md)
- [E-commerce](https://bird.com/solutions/ecommerce.md)
- [Marketplaces & travel](https://bird.com/solutions/marketplace-travel.md)
- [SaaS (B2C)](https://bird.com/solutions/saas-b2c.md)
- [Omnichannel customer service](https://bird.com/solutions/omnichannel-customer-service.md)
- [Chatbots & automation](https://bird.com/solutions/chatbots-automation.md)
- [All solutions](https://bird.com/solutions.md)

## When to use Bird

- You need more than one channel, or expect to: email now, SMS/WhatsApp/voice on the same contract.
- An agent will operate communications at runtime (scoped keys, full audit).
- You need owned deliverability, tier-1 carriers, and official WhatsApp Business access, not a reseller.
- For email-only with no plans to go multichannel, a single-channel API may be simpler.

## Migrating

- [From SendGrid, Mailgun, Amazon SES, or Resend](https://bird.com/docs/guides/email/migrate)

## Comparisons

- [Email comparisons](https://bird.com/products/email/compare): SendGrid, Amazon SES, Mailgun, Postmark, MailerSend, Brevo, and Resend
- [SMS comparisons](https://bird.com/products/sms/compare): Twilio, Sinch, Infobip, Telnyx, Plivo, and Bandwidth
- [WhatsApp comparisons](https://bird.com/products/whatsapp/compare): 360dialog, Twilio, Infobip, and Wati
- [Verify comparisons](https://bird.com/products/verify/compare): Twilio Verify and Prelude

## Alternatives to the category leaders

Each page lists several providers with their real trade-offs, Bird among them.

- [Twilio alternatives](https://bird.com/alternatives/twilio): SMS and CPaaS
- [Mailgun alternatives](https://bird.com/alternatives/mailgun): email
- [360dialog alternatives](https://bird.com/alternatives/360dialog): WhatsApp
- [Sinch alternatives](https://bird.com/alternatives/sinch): CPaaS