{"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":"twilio/whatsapp-sender","name":"Twilio WhatsApp sender (Self Sign-up)","vendor":"Twilio","status":"researched","last_verified":null,"last_researched":"2026-10-25","summary":"Register a phone number as a WhatsApp sender through Twilio, using Meta's pop-up to create or pick a Meta Business Portfolio and WhatsApp Business Account. Meta business verification is needed before production scale.","account_model":{"summary":"The WhatsApp sender is a phone number registered in a WhatsApp Business Account (WABA) that is owned by a Meta Business Portfolio and connected to your Twilio account. One Twilio account can only use one WABA, so every further sender must use the same portfolio and WABA.","accounts":[{"name":"Twilio account (paid)","kind":"organisation","required":true},{"name":"Meta Business Portfolio","kind":"organisation","owned_by":"the company (you need admin access)","required":true,"note":"Can be created inside the sign-up pop-up."},{"name":"WhatsApp Business Account (WABA)","kind":"other","parent":"Meta Business Portfolio","required":true,"note":"Create it during Twilio Self Sign-up; do not reuse a WABA created outside Twilio."},{"name":"WhatsApp sender (phone number)","kind":"other","parent":"WhatsApp Business Account (WABA)","required":true}]},"prerequisites":[{"entry":"twilio/account-and-keys","note":"The Twilio account must be upgraded from trial."},{"entry":"meta/whatsapp","note":"Background on WhatsApp Business rules and Meta business verification."},{"need":"A Facebook login with admin rights on (or able to create) a Meta Business Portfolio"}],"identity_requires":[],"have_ready":[{"kind":"other","description":"A phone number not currently registered on WhatsApp (Twilio or your own) that can receive an SMS or voice code","why":"Numbers already on WhatsApp fail (error 63110); IVR or outbound-only numbers cannot receive the code.","needed_for":["pick-number","verify-number"],"auto_check":"none","source_url":"https://www.twilio.com/docs/whatsapp/self-sign-up"},{"kind":"other","description":"A display name that follows Meta's display name guidelines and matches your brand","why":"A rejected display name limits the number to 250 business-initiated messages per 24 hours and may lead Meta to disconnect it.","needed_for":["business-profile"],"auto_check":"none","source_url":"https://www.twilio.com/docs/whatsapp/self-sign-up"},{"kind":"company_documents","description":"Legal business documents for Meta business verification","why":"Unverified portfolios cannot move to production scale or add more than two senders. Document list is set by Meta (see the meta entries).","needed_for":["meta-business-verification"],"auto_check":"none","source_url":"https://www.twilio.com/docs/whatsapp/self-sign-up"},{"kind":"live_website","description":"A live business website matching the business name","why":"Used in the business profile and Meta business verification. [to verify for Twilio flow]","needed_for":["meta-business-verification"],"auto_check":"website_live","source_url":null}],"steps":[{"id":"account","title":"Use an upgraded Twilio account","summary":"Sign in to Twilio; the account must be paid, not trial.","route":"guided","gate":"human_login","human_only":true,"gate_label":"You sign in","depends_on":[],"optional":false,"url":null,"lead_time":null,"preflight":[],"captures":null},{"id":"pick-number","title":"Start a new WhatsApp sender","summary":"In Console go to Messaging > Senders > WhatsApp Senders > Create new sender and choose the number.","route":"copilot","gate":"none","human_only":false,"gate_label":null,"depends_on":["account"],"optional":false,"url":"https://console.twilio.com/","lead_time":null,"preflight":[],"captures":null},{"id":"meta-pop-up","title":"Continue with Facebook","summary":"Click Continue with Facebook and log in yourself. Approve permissions, create or pick the Meta Business Portfolio and WABA, and enter the account name, display name and category. Keep both windows open in the same browser and never share the pop-up URL.","route":"guided","gate":"human_terms","human_only":true,"gate_label":"You accept the terms","depends_on":["pick-number"],"optional":false,"url":null,"lead_time":null,"preflight":[],"captures":null},{"id":"business-profile","title":"Set the WhatsApp Business profile","summary":"Enter the customer-facing display name and category in the pop-up. Do not choose \"Use a display name only\" (a 555 number Twilio does not support).","route":"guided","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":["meta-pop-up"],"optional":false,"url":null,"lead_time":null,"preflight":["display_name_matches_business"],"captures":null},{"id":"verify-number","title":"Verify the number with a code","summary":"Enter the one-time code. Twilio SMS numbers show it in the Console; Twilio voice-only numbers need the Voicemail Twimlet so the code arrives by email (up to 10 minutes); other numbers get it by SMS or call.","route":"guided","gate":"2fa","human_only":true,"gate_label":"You enter a 2-step code","depends_on":["business-profile"],"optional":false,"url":null,"lead_time":{"official":{"text":"Registration completes a few minutes after you confirm; voice code emails can take up to 10 minutes.","source_url":"https://www.twilio.com/docs/whatsapp/self-sign-up","source_title":"Twilio docs – Register WhatsApp senders with Self Sign-up"},"reported":null,"typical_minutes":null},"preflight":[],"captures":null},{"id":"confirm-access","title":"Approve Twilio's access request","summary":"Review and confirm the access request so Twilio can send for your WABA.","route":"guided","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":["verify-number"],"optional":false,"url":null,"lead_time":null,"preflight":[],"captures":null},{"id":"meta-business-verification","title":"Complete Meta business verification","summary":"If the portfolio is new or unverified, verify it in Meta Security Center before production. It is free (not the Meta Verified subscription) and unlocks higher limits and more than two senders.","route":"guided","gate":"third_party_review","human_only":true,"gate_label":"The provider reviews it","depends_on":["confirm-access"],"optional":false,"url":null,"lead_time":{"official":{"text":"Twilio says Meta business verification can take several weeks depending on region; start early.","source_url":"https://www.twilio.com/docs/whatsapp/self-sign-up","source_title":"Twilio docs – Register WhatsApp senders with Self Sign-up"},"reported":null,"typical_minutes":null},"preflight":[],"captures":null},{"id":"templates","title":"Create and submit message templates","summary":"Create templates in the Content Template Builder; choose the category explicitly (Content Editor or API) so Meta does not override it.","route":"guided","gate":"third_party_review","human_only":true,"gate_label":"The provider reviews it","depends_on":["confirm-access"],"optional":false,"url":null,"lead_time":{"official":{"text":"Usually approved within minutes; templates needing human review can take up to 48 hours.","source_url":"https://www.twilio.com/docs/whatsapp/tutorial/message-template-approvals-statuses","source_title":"Twilio docs – WhatsApp message template approvals and statuses"},"reported":null,"typical_minutes":null},"preflight":[],"captures":null}],"gates":[{"step":"account","gate":"human_login","label":"You sign in"},{"step":"meta-pop-up","gate":"human_terms","label":"You accept the terms"},{"step":"business-profile","gate":"human_submit","label":"You press submit"},{"step":"verify-number","gate":"2fa","label":"You enter a 2-step code"},{"step":"confirm-access","gate":"human_submit","label":"You press submit"},{"step":"meta-business-verification","gate":"third_party_review","label":"The provider reviews it"},{"step":"templates","gate":"third_party_review","label":"The provider reviews it"}],"lead_times":[{"step":"verify-number","what":"Verify the number with a code","official":{"text":"Registration completes a few minutes after you confirm; voice code emails can take up to 10 minutes.","source_url":"https://www.twilio.com/docs/whatsapp/self-sign-up","source_title":"Twilio docs – Register WhatsApp senders with Self Sign-up"},"reported":null},{"step":"meta-business-verification","what":"Complete Meta business verification","official":{"text":"Twilio says Meta business verification can take several weeks depending on region; start early.","source_url":"https://www.twilio.com/docs/whatsapp/self-sign-up","source_title":"Twilio docs – Register WhatsApp senders with Self Sign-up"},"reported":null},{"step":"templates","what":"Create and submit message templates","official":{"text":"Usually approved within minutes; templates needing human review can take up to 48 hours.","source_url":"https://www.twilio.com/docs/whatsapp/tutorial/message-template-approvals-statuses","source_title":"Twilio docs – WhatsApp message template approvals and statuses"},"reported":null}],"outputs":[{"name":"TWILIO_WHATSAPP_FROM","description":"WhatsApp sender address used as From","secret":false,"example_format":"whatsapp:+<E.164 number>","environments":null}],"renewals":[],"estimated_minutes":null,"guide_url":"https://verapli.com/guides/twilio/whatsapp-sender"}