Getting started with SMS
Send your first test SMS.
Test delivery on your own phone before messaging customers.
Built with BirdCustomer stories
Customer storiesBuilt with Bird
Trusted by engineering and product teams shipping at global scale.
Three steps from your first test message to carrier-compliant sending.
Enable your target destinations and sender identity first, then verify webhook signatures and delivery status handling before messaging live customers.
01Create a regional API key and fund your wallet.
Sign up for Bird, top up your organization's prepaid wallet, and issue a US or EU API key with SMS permissions. Store the key in your backend environment variables so the Bird SDK can route requests to the matching regional host.02Enable destination countries and prepare your sender.
Turn on the destination countries your application needs in the dashboard or CLI so unapproved markets stay blocked by default. For a quick first test to your own phone, you can send a built-in verification template over a shared sender; for ongoing customer traffic, lease a number or configure an alphanumeric sender ID and complete the country's registration requirements (holding a number and carrier approval to send from it are separate checks). Read the sender guide →03Verify delivery events and error handling.
Send to Bird's documented US sandbox recipient (with an enabled US destination and eligible US sender) to exercise the message lifecycle without texting a real handset, or send a live test to your own mobile number. Verify signed webhook payloads and inspect carrier delivery statuses before opening traffic to customers. Sending and testing guide →
Frequently asked questionsExplained
ExplainedFrequently asked questions
Questions before your first send
How do I test my SMS integration?
Follow the sending guide with a regional API key, an enabled US destination and a suitable US sender. Send to the documented sandbox recipient +15005550006 to exercise delivery events without contacting a real recipient. A message to your own phone is a real send.
What does Bird SMS include?
Send messages, receive replies, manage senders and destinations, and inspect delivery outcomes. The product hub connects number types, registration, campaigns, analytics and the corresponding setup guides.
Which countries can I send to?
Use the destination catalogue to check current coverage, sender types and registration requirements. Enable the destination in your workspace before sending; coverage alone does not complete your sender setup.
When do I need 10DLC registration?
US application-to-person messaging from local ten-digit numbers uses 10DLC brand and campaign registration. Toll-free and short-code programs have their own requirements. Choose the sender type first and follow its registration guide.
Choose your next step
- Explore the SMS platformDeliver transactional alerts, handle two-way customer replies, and manage country-specific sender compliance from one platform.
- Prepare an audience campaignTarget opted-in audience segments, preview GSM-7 and Unicode segment counts, and schedule compliant promotional broadcasts.
- Find a guide or answerBrowse country regulations, 10DLC and sender registration guides, and the interactive SMS segment calculator.
Send your first SMS in minutes.
Enable your destination country, run a sandbox or handset test, and verify delivery webhooks before rolling out customer notifications and campaigns.
Your next ideaStart building
Start buildingYour next idea