---
title: "Bird"
canonical: "https://bird.com/"
---

# Bird

> Bird connects customer communications across email, SMS, WhatsApp, Apple
> Messages and voice, with verification, lookup, mailboxes, eSIM and realtime
> tools. Build with the API, SDKs, CLI or hosted MCP server.

## Check capabilities before integrating

- **Email, SMS and WhatsApp**: send messages and inspect their delivery through
  the developer API. WhatsApp also exposes reads for templates, numbers and
  aggregate stats. Check the operation reference for supported writes.
- **Verify**: create a verification to send a one-time passcode, check the code
  the user enters, and resend on the next channel through the developer API.
  Listing and reading verifications is available in the dashboard only.
- **Voice**: read call legs through the developer API. Use the Voice and SIP
  guides to choose a calling integration.
- **Receiving, setup and administration**: support varies by product and operation.
  Read the product guide and discover the available tools before acting.
- Use the live MCP tool list and OpenAPI specification to verify operations,
  authorization, required inputs and response states.

## Start here

- [Quickstart](https://bird.com/docs/get-started/send-your-first-email): Create an API key and send your first email
- [SMS quickstart](https://bird.com/docs/get-started/send-your-first-sms): Enable a destination, send a built-in template SMS, and read its delivery status
- [Verify quickstart](https://bird.com/docs/get-started/verify-your-first-customer): Send a one-time passcode and check the code
- Install the CLI: `curl 'https://cli.bird.com/install.sh' | sh`, or with Homebrew: `brew install messagebird/tap/bird`
- 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`.
  In Claude, add Bird from the connector directory: https://claude.ai/directory/bird
  Install Bird in Codex: codex://plugins/plugin_asdk_app_6ac74d2aa37481918759cbb0ea8aa6c6
  Or in ChatGPT: https://chatgpt.com/plugins/plugin_asdk_app_6ac74d2aa37481918759cbb0ea8aa6c6
  Other hosts: https://bird.com/docs/ai/mcp-server#connect-a-client

## Get help

- Stuck or have ideas? `bird platform feedback` (MCP: `platform_feedback`) tells us what to improve; `bird platform support create` (MCP: `platform_support_create`) gets you help when something is broken. `bird platform status` shows Bird's service status.

## For AI agents

- [MCP server](https://bird.com/docs/ai/mcp-server): Hosted at mcp.bird.com. OAuth authentication, 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): English authored guides in one file; generated operation references are available separately

## 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
- [Search the docs](https://us1.platform.bird.com/v1/docs/search?q=webhook+signature&limit=3): public GET endpoint; set `q` to your task. Read the matching `markdown_url` and linked references before loading a larger corpus
- [Sitemap](https://bird.com/sitemap.xml): Indexable pages by 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

- [Documentation index (Markdown)](https://bird.com/docs/llms.txt): Published English documentation twins
- [API index (Markdown)](https://bird.com/api/llms.txt): API guides and operation-reference twins
- [API reference (Markdown)](https://bird.com/docs/api.md): Product map of the setup, send and outcome calls, and the agent entry points
- [SDKs (Markdown)](https://bird.com/docs/sdks.md): TypeScript/JavaScript, Python, Go and PHP; Swift and Kotlin for Realtime
- SDK packages: [@messagebird/sdk on npm](https://www.npmjs.com/package/@messagebird/sdk), [messagebird-sdk on PyPI](https://pypi.org/project/messagebird-sdk/), [messagebird/sdk on Packagist](https://packagist.org/packages/messagebird/sdk), [github.com/messagebird/bird-sdk-go](https://pkg.go.dev/github.com/messagebird/bird-sdk-go)
- [CLI (Markdown)](https://bird.com/docs/cli.md)
- [Integration guides](https://bird.com/docs/guides): Authentication, idempotency, errors, webhooks, pagination and rate limits; check each operation for applicability
- [Email sandbox](https://bird.com/docs/guides/email/testing-sandbox): Test delivery and bounce outcomes with sandbox recipients
- [API errors](https://bird.com/docs/guides/errors): Identify the rejected field and the reason before correcting a request
- [Deprecation policy](https://bird.com/docs/api/deprecations): How the API marks deprecated fields, parameters and body shapes, including the `Deprecation` response header
- [Webhooks](https://bird.com/docs/guides/webhooks): Verify webhook signatures with the SDK and handle delivery events in your application
- [Idempotency](https://bird.com/docs/guides/idempotency): Retry a completed request with the same key and body within the retention window to retrieve its cached response
- [Changelog](https://bird.com/changelog) · [Status](https://bird.com/status)

Ready to build? [Get Started](https://bird.com/dashboard/signup) or [Contact Sales](https://bird.com/demo).

## Build templates and workflows in the dashboard.

- [WhatsApp templates](https://bird.com/docs/guides/whatsapp/authoring-templates): Build messages with variables and buttons, preview sample values, and submit languages for review
- [Automations](https://bird.com/docs/get-started/automations): Connect application events to messaging actions in a visual workflow
- [Voice sequences](https://bird.com/docs/guides/voice/sequence-builder): Build call flows with keypad menus and spoken responses
- [Email mailboxes](https://bird.com/docs/guides/email/mailboxes): Read conversations, reply in a thread, and track the delivery of sent messages

## Track delivery and call outcomes across your channels.

Monitor delivery rates in real time, break down bounces and carrier failures, and trace any dip to the exact server response, network, or call leg.
Inspect email bounce types and receiving-server responses, separate SMS non-delivery
outcomes, and compare voice answer rates by destination before opening individual call legs.

- [Email analytics](https://bird.com/docs/guides/email/tracking-and-metrics): Delivery, engagement, bounces, receiving-server responses, and latency
- [SMS analytics](https://bird.com/docs/guides/sms/tracking-and-metrics): Accepted messages, delivery rates, non-delivery outcomes, and latency
- [WhatsApp analytics](https://bird.com/docs/guides/whatsapp/tracking-and-metrics): Delivery, reads, failures, and template breakdowns
- [Apple Messages analytics](https://bird.com/docs/guides/apple-messages/analytics): Accepted sends, gateway outcomes, and conversation activity
- [Voice analytics](https://bird.com/docs/guides/voice/tracking-and-metrics): Call-leg volume, answer rates, destinations, and call quality

## Personalize your campaigns from your contact profiles.

Group contacts into reusable audiences and personalize broadcasts with each recipient's profile attributes, from first name and city to membership tier. A broadcast
uses each recipient's contact properties to personalize the email template.

- [Contacts & properties](https://bird.com/docs/guides/email/contacts): Store contact details and typed custom properties for personalization
- [Audiences](https://bird.com/docs/guides/email/audiences): Group contacts into reusable lists with explicit membership
- [Explore broadcasts](https://bird.com/docs/guides/email/broadcasts): Preview, schedule, and send a personalized email to an audience

## 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.
API keys belong to a workspace and carry editable permissions. When an admin changes
a key's scopes, the audit log records the actor, workspace, time, and scope changes.

- [Workspaces](https://bird.com/docs/guides/workspaces): Keep resources and access in their workspace
- [Team roles](https://bird.com/docs/guides/users-teams-roles): Give people admin, developer, or analyst access
- [API authentication](https://bird.com/docs/guides/authentication): Scope, edit, rotate, and revoke API keys
- [Audit logs](https://bird.com/docs/knowledge-base/account-security/audit-log): Review configuration and security changes
- [Explore Enterprise](https://bird.com/enterprise): Organization controls and security resources

## Products

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

- [Email](https://bird.com/email-api.md)
- [SMS](https://bird.com/sms-api.md)
- [WhatsApp](https://bird.com/whatsapp-api.md)
- [Customer verification](https://bird.com/verify-api.md)
- [Voice](https://bird.com/voice-api.md)
- [Realtime](https://bird.com/realtime-api.md)
- [Lookup](https://bird.com/lookup-api.md)
- [eSIM](https://bird.com/esim-api.md)
- [Apple Messages for Business](https://bird.com/apple-messages-api.md)
- [Agent mailboxes](https://bird.com/mailbox-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: start with email and add SMS, WhatsApp or voice.
- 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

- [Email migration guides](https://bird.com/docs/guides/email/migrate)

## Comparisons

- [Email comparisons](https://bird.com/email-api/compare): Compare email providers and migration paths
- [SMS comparisons](https://bird.com/sms-api/compare): Twilio, Sinch, Infobip, Telnyx, Plivo, and Bandwidth
- [WhatsApp comparisons](https://bird.com/whatsapp-api/compare): 360dialog, Twilio, Infobip, and Wati
- [Verify comparisons](https://bird.com/verify-api/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