# SMS API for developers

Send order alerts, appointment reminders, and marketing campaigns that reach customers on time. Handle two-way replies across global carriers with Bird SDKs, CLI, and MCP.

## From prompt to delivered.

Send a confirmation text or reminder and verify its carrier delivery receipt as soon as it arrives. If messages start failing, break down recent delivery rates by carrier to see where traffic is dropping.

### MCP CLI

- **Node.js**  
- **Python**  
- **Go**  
- **PHP**  
- **cURL**

**sms_send**  
Accepted / Sending

**sms_get**  
Delivered / Checking

**sms_stats_summary**  
Reading

**sms_stats_by_carrier**  
Comparing

## Match your SMS sender to each destination country.

Send from your brand name where supported, or use local, toll-free, and 10DLC numbers when a country requires them. See clearly which countries are ready to send, under review, or waiting on registration before you launch.

### Supported Countries
- United States
- Netherlands
- India

## Make every character count.

A single curly quote can silently split one text into two billable segments. Preview the final message length with customer data filled in, and let smart encoding replace hidden characters so you avoid paying for extra segments.

## Receive customer replies and route them into your app.

Let customers confirm appointments, reschedule deliveries, or reply to support right from their messages app. Route incoming texts straight into your application and reply from the same number.

### Example Message
> Hi Maya, your appointment is tomorrow at 10:00. Reply YES to confirm.

**YES**

You’re confirmed, Maya. See you tomorrow at 10:00.

### Honor the next STOP.

When a customer replies STOP, Bird automatically blocks future texts to that number in supported countries so you stay compliant without building your own suppression logic. You can also enforce opt-outs across your entire workspace.

**Opted out**
- +14155550100 / Stop keyword
- +14155550123 / Stop keyword
- +14155550147 / Stop keyword
- +14155550162 / Stop keyword
- +14155550178 / Stop keyword

## Every message. A clearer picture.

Track delivery rates in real time across countries and mobile networks. When messages fail, see right away whether the issue is a specific carrier, an unreachable phone, or an invalid number.

### Statistics
- **Failure rate**: 1.18%  
- **Delivery rate**: 99%

## Built for the next market.

Airwallex expanded SMS into 30 new countries in two months with Bird, bringing its authentication messages to more customers.

**30** new countries in two months

## Catch integration issues early and ship with confidence.

Simulate failure paths in the sandbox, verify signed webhooks, and retry timed-out requests without sending duplicates.

### JSON Request Example
```json
{  "method": "POST",  "url": "/v1/sms/messages",  "body": {    "to": "+14155550100",    "from": "+15557654321",    "text": "Hi Maya, your appointment at Harbor is tomorrow at 10:00. Reply YES to confirm.",    "category": "transactional"  }}
```

### Command Line Example
```
$ bird sms send --body-file reminder.json --dry-run
```

## 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.

## Go further. With SMS API.

Transactional alerts, two-way conversations, and global sender compliance in one place.

### Features
- **Sending API**: Send order updates, reminders, and alerts with real-time carrier delivery receipts.
- **Numbers**: Text from your brand name, local numbers, toll-free numbers, or short codes.
- **Destinations**: Check country rules, supported sender types, and registration requirements before launching.
- **Two-way messaging**: Receive customer replies and let people confirm, reschedule, or ask for help by text.
- **Routing**: Deliver messages reliably across global mobile networks with direct carrier connections.
- **Marketing**: Send promotions, product drops, and announcements to opted-in customer segments.
- **Templates**: Personalize reusable templates and preview character and segment counts before sending.
- **Compliance**: Automate STOP opt-outs and keep country registrations organized in one workspace.
- **10DLC registration**: Register your US brand and campaigns to protect throughput and avoid carrier filtering.

## Before your first message.

### FAQs
- **Can I send from my business name?**
  Yes, in most countries outside North America you can send one-way texts displaying your brand name as the sender. Some countries require quick pre-registration first.
- **What determines the cost of an SMS?**
  Pricing depends on the destination country, the mobile carrier, and how many segments your message uses.
- **Does accepted mean delivered?**
  No. Accepted means Bird received your request and queued the text for the mobile network.
- **How do replies and opt-outs reach my application?**
  When a customer texts your number, Bird forwards the message straight to your webhook so your app can respond.

## Start building with Bird in minutes.
