{"registry_version":"2026.1025.387","generated_at":"2026-10-25T06:27:00Z","content_sha256":"089d16f627d9365e3d0663cc8069203706d7cb23a76c332226e29686968811a5","signed":true,"signature":{"key_id":"ed25519:74ca19268e364242","algorithm":"ed25519","expires_at":"2026-11-24T06:27:09Z","expired":false,"manifest":"/registry/manifest.json"},"entry_sha256":"91c1323268aa1faf5fb1a699dcd62e51d0d93169c7cd18871b37f2ed64eaa6d5","entry":{"id":"messagebird-bird/sms","name":"Bird SMS API (formerly MessageBird)","vendor":"Bird","summary":"Send SMS through the bird.com platform with a region-scoped API key (bk_us1_… / bk_eu1_…). Sending draws on a prepaid wallet, only reaches countries you enable, and custom senders need business identity verification and, in many countries, sender registration. Legacy MessageBird accounts and keys are a separate system.","aliases":["messagebird","bird","bird-sms"],"category":"messaging","group":"B","homepage":"https://bird.com/","docs":["https://bird.com/docs/get-started/send-your-first-sms","https://bird.com/docs/guides/sms/sending-sms","https://bird.com/docs/guides/sms/senders"],"status":"researched","last_verified":null,"last_researched":"2026-10-25","sources":[{"id":"first-sms","url":"https://bird.com/docs/get-started/send-your-first-sms","title":"Bird docs – Send your first SMS","accessed":"2026-10-25","supports":"API keys under Platform tools > API keys; sms:write scope; keys region-scoped bk_us1_/bk_eu1_ with matching host; full key shown only at creation; wallet funds sends (402 WalletInsufficientBalance); enable destination countries (422 SMSDestinationNotEnabled); quickstart template uses a shared sender with no registration","kind":"official"},{"id":"sending","url":"https://bird.com/docs/guides/sms/sending-sms","title":"Bird docs – Sending SMS","accessed":"2026-10-25","supports":"Regional hosts us1/eu1.platform.bird.com; POST /v1/sms/messages; destination allowlist starts empty except home country from business profile; US does not support alphanumeric senders","kind":"official"},{"id":"senders","url":"https://bird.com/docs/guides/sms/senders","title":"Bird docs – SMS sender IDs","accessed":"2026-10-25","supports":"Sender types (alphanumeric, long code, toll-free, short code); 412 means finish identity verification first; per-country registration modes; US 10DLC and toll-free have own programmes; toll-free submit must be authorised in dashboard; timeline_min_days/max_days; rejection_reason and Resubmit","kind":"official"},{"id":"tendlc","url":"https://bird.com/products/sms/compliance/10dlc","title":"Bird – 10DLC compliance","accessed":"2026-10-25","supports":"Brand, campaign, link numbers, poll until approved; separate brand, vetting and recurring campaign fees; corrected resubmission can be a new chargeable attempt; use case cannot be changed later","kind":"official"},{"id":"biz-verify","url":"https://bird.com/docs/knowledge-base/compliance/business-verification","title":"Bird knowledge base – Business verification","accessed":"2026-10-25","supports":"Legal name exactly as in companies register plus registration number (VAT number not accepted); an organisation owner provides a photo of ID; rejection shows only failed answers with reasons, then Resubmit details; sole proprietor guidance","kind":"official"},{"id":"create-account","url":"https://bird.com/docs/knowledge-base/getting-started/create-account","title":"Bird knowledge base – Create an account and workspace","accessed":"2026-10-25","supports":"Sign up with work email; verify by link or six-digit code; workspace holds API keys; a key only accesses its own workspace","kind":"official"},{"id":"legacy","url":"https://bird.com/docs/knowledge-base/account/coming-from-messagebird","title":"Bird knowledge base – Accounts from MessageBird and earlier Bird platforms","accessed":"2026-10-25","supports":"MessageBird account is separate from bird.com account; MessageBird keys work only on rest.messagebird.com; bk_ keys do not work there; credits not transferable; wallet model on bird.com","kind":"official"},{"id":"pricing","url":"https://bird.com/docs/knowledge-base/billing/plans-and-pricing","title":"Bird knowledge base – Plans and pricing","accessed":"2026-10-25","supports":"SMS priced per segment by destination (and carrier in some countries); wallet charged as you send; no free SMS allowance described","kind":"official"},{"id":"aup","url":"https://bird.com/docs/knowledge-base/policies/acceptable-use","title":"Bird knowledge base – Acceptable use","accessed":"2026-10-25","supports":"Consent required; honour opt-outs; spam, phishing, spoofing prohibited; Bird may reject requests, place account under review or suspend access; binding text at bird.com/legal/acceptable-use-policy","kind":"official"}],"allowed_domains":["bird.com"],"account_model":{"summary":"A bird.com organisation holds billing (wallet) and members; work happens in workspaces, which hold API keys, senders and message history. API keys are scoped to one workspace and one region. Legacy MessageBird (dashboard.messagebird.com) and Bird Engagement Platform (app.bird.com) accounts are separate.","accounts":[{"name":"bird.com organisation","kind":"billing","owned_by":"the company","required":true,"note":"Holds the wallet and the owners who complete identity verification."},{"name":"Workspace","kind":"project","parent":"bird.com organisation","required":true}],"notes":["Tools with built-in \"MessageBird\" support (for example older phone sign-in integrations) need a legacy MessageBird access key and will not work with a bird.com key."]},"prerequisites":[{"need":"A work email address"}],"have_ready":[{"kind":"company_documents","description":"Legal company name exactly as in the companies register and the company registration number (not the VAT number)","why":"Required for business verification before custom senders.","needed_for":["business-verification"],"auto_check":"name_consistency","source":"biz-verify"},{"kind":"government_id","description":"Photo ID of an organisation owner","why":"An owner must provide a photo of their ID for identity verification.","needed_for":["business-verification"],"auto_check":"none","source":"biz-verify"},{"kind":"payment_card","description":"A payment method to top up the wallet","why":"Sends fail with 402 when the wallet cannot cover them.","needed_for":["fund-wallet"],"auto_check":"none","source":"first-sms"}],"steps":[{"id":"sign-up","title":"Create a bird.com account","summary":"Sign up with your work email and confirm with the emailed link or six-digit code.","route":"guided","depends_on":[],"gate":"human_submit","url":"https://bird.com/","lead_time":{"typical_minutes":5},"sources":["create-account"]},{"id":"fund-wallet","title":"Top up the wallet","summary":"Add a payment method and fund the organisation wallet; SMS is charged per segment from it.","route":"guided","depends_on":["sign-up"],"gate":"human_payment","recovery":[{"hiccup":"Send fails with 402 WalletInsufficientBalance","code":"402","fix":"Top up the wallet, then retry.","source":"first-sms"}],"sources":["first-sms","pricing"]},{"id":"enable-destinations","title":"Enable destination countries","summary":"Under SMS > Destinations enable each country you send to; only your home country is added automatically.","route":"guided","depends_on":["sign-up"],"gate":"none","recovery":[{"hiccup":"Send fails with 422 SMSDestinationNotEnabled","code":"422","fix":"Enable the recipient's country under SMS > Destinations.","source":"first-sms"}],"sources":["sending"]},{"id":"create-api-key","title":"Create an API key","summary":"In Platform tools > API keys create a key with the sms:write scope in the region you will use. The full key shows once; verapli captures it to your vault.","route":"copilot","depends_on":["sign-up"],"gate":"human_submit","url":"https://bird.com/dashboard","recovery":[{"hiccup":"Requests rejected although the key is right","fix":"Use the host that matches the key prefix (bk_us1_ → us1.platform.bird.com, bk_eu1_ → eu1.platform.bird.com).","source":"first-sms"}],"capture":{"env":"BIRD_API_KEY","kind":"api_key"},"sources":["first-sms"]},{"id":"business-verification","title":"Verify your business identity","summary":"An owner enters the legal name and registration number and provides a photo ID through Bird's verification flow. Needed before claiming senders or buying numbers.","route":"guided","depends_on":["sign-up"],"gate":"human_identity","preflight":["legal_name_matches_documents"],"recovery":[{"hiccup":"Claiming a sender returns 412","code":"412","fix":"Finish identity verification first.","source":"senders"},{"hiccup":"Verification rejected","fix":"Correct only the answers the reviewer flagged, upload replacement documents and select Resubmit details; contact support if an accepted answer is wrong.","source":"biz-verify"}],"sources":["biz-verify","senders"]},{"id":"sender","title":"Set up a sender and any country registration","summary":"Claim an alphanumeric sender ID, or get a number. Check each country's registration mode; where it is required, sending is blocked until approved. US long codes use the 10DLC programme and toll-free numbers the toll-free verification programme, which you authorise in the dashboard.","route":"guided","depends_on":["business-verification","fund-wallet"],"gate":"third_party_review","lead_time":{"official":{"text":"Varies by country; each country row gives a typical range in business days (timeline_min_days / timeline_max_days), null where none is published.","source":"senders"}},"recovery":[{"hiccup":"Sender registration rejected","fix":"Read rejection_reason, fix it and select Resubmit (or Complete if the form was closed but accepts corrections); otherwise contact support.","source":"senders"},{"hiccup":"Need a different US use case on an approved campaign","fix":"The use case cannot be changed; register a new campaign (fees may apply again).","source":"tendlc"}],"sources":["senders","tendlc"]}],"outputs":[{"name":"BIRD_API_KEY","description":"bird.com API key (region-scoped)","secret":true,"example_format":"bk_us1_… or bk_eu1_…","from_step":"create-api-key"}],"terms_notes":[{"kind":"rules_say","severity":"red","text":"Bird may reject requests, put the account under review or suspend access for spam, phishing, spoofed senders, or messaging people who did not consent or opted out.","source":"aup"},{"kind":"rules_say","severity":"amber","text":"US 10DLC carries brand, vetting and recurring campaign fees, and a corrected resubmission can count as a new chargeable attempt.","source":"tendlc"},{"kind":"rules_say","severity":"yellow","text":"Legacy MessageBird keys and credits do not carry over to bird.com; integrations that expect a MessageBird access key will not work with a bird.com key.","source":"legacy"}],"pricing_notes":{"costs":"Per SMS segment by destination country (and carrier in some countries), charged from a prepaid wallet.","notes":"No free SMS allowance is described; funding plans add a monthly wallet deposit.","source":"pricing"},"stripe_projects":false,"api_provisioning":{"available":"partial","notes":"Sender registrations, destinations and 10DLC status can be managed by API/CLI once an API key exists; account, payment and identity verification are human-only.","docs":["https://bird.com/docs/guides/sms/senders"],"source":"senders"},"detect":{"env_names":["BIRD_API_KEY","MESSAGEBIRD_API_KEY","MESSAGEBIRD_ACCESS_KEY"],"packages":["messagebird"]}}}