{"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"},"id":"messagebird-bird/sms","name":"Bird SMS API (formerly MessageBird)","vendor":"Bird","status":"researched","last_verified":null,"last_researched":"2026-10-25","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.","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"}],"identity_requires":[],"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_url":"https://bird.com/docs/knowledge-base/compliance/business-verification"},{"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_url":"https://bird.com/docs/knowledge-base/compliance/business-verification"},{"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_url":"https://bird.com/docs/get-started/send-your-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","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":[],"optional":false,"url":"https://bird.com/","lead_time":{"official":null,"reported":null,"typical_minutes":5},"preflight":[],"captures":null},{"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","gate":"human_payment","human_only":true,"gate_label":"You add payment details","depends_on":["sign-up"],"optional":false,"url":null,"lead_time":null,"preflight":[],"captures":null},{"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","gate":"none","human_only":false,"gate_label":null,"depends_on":["sign-up"],"optional":false,"url":null,"lead_time":null,"preflight":[],"captures":null},{"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","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":["sign-up"],"optional":false,"url":"https://bird.com/dashboard","lead_time":null,"preflight":[],"captures":"BIRD_API_KEY"},{"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","gate":"human_identity","human_only":true,"gate_label":"You prove your identity","depends_on":["sign-up"],"optional":false,"url":null,"lead_time":null,"preflight":["legal_name_matches_documents"],"captures":null},{"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","gate":"third_party_review","human_only":true,"gate_label":"The provider reviews it","depends_on":["business-verification","fund-wallet"],"optional":false,"url":null,"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_url":"https://bird.com/docs/guides/sms/senders","source_title":"Bird docs – SMS sender IDs"},"reported":null,"typical_minutes":null},"preflight":[],"captures":null}],"gates":[{"step":"sign-up","gate":"human_submit","label":"You press submit"},{"step":"fund-wallet","gate":"human_payment","label":"You add payment details"},{"step":"create-api-key","gate":"human_submit","label":"You press submit"},{"step":"business-verification","gate":"human_identity","label":"You prove your identity"},{"step":"sender","gate":"third_party_review","label":"The provider reviews it"}],"lead_times":[{"step":"sender","what":"Set up a sender and any country registration","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_url":"https://bird.com/docs/guides/sms/senders","source_title":"Bird docs – SMS sender IDs"},"reported":null}],"outputs":[{"name":"BIRD_API_KEY","description":"bird.com API key (region-scoped)","secret":true,"example_format":"bk_us1_… or bk_eu1_…","environments":null}],"renewals":[],"estimated_minutes":5,"guide_url":"https://verapli.com/guides/messagebird-bird/sms"}