Use an existing WhatsApp phone number

If you already use a WhatsApp number with another provider, you don’t need to move it. Share your WhatsApp account with Braze through Embedded Signup. Your number, conversations, and other providers stay in place. Templates and billing are separate for each provider, so recreate the templates you need in your Braze Messaging account.

Prerequisites

Before you connect an existing number to Braze, confirm your phone number meets Meta’s requirements:

• Your Meta Business account is verified.
• You can complete Meta’s Embedded Signup flow with a Meta user who has permission to share the WhatsApp account with Braze.
• You understand that templates and billing stay separate per Messaging account. Recreate any templates you need to send from Braze.

Use a number that’s already with another provider

If your WhatsApp phone number is already registered with another Business Solution Provider (BSP), share the WhatsApp account that holds that number with Braze. You don’t need to remove the other provider for Braze to send on the number.

Before you connect

• A phone number can stay available to more than one provider at a time. Sharing with Braze does not remove the current provider’s access unless you later revoke that access in Meta.
• Templates aren’t shared across Messaging accounts. Recreate the templates you need in your Braze Messaging account. Migrated or recreated templates start from a baseline quality rating; Meta’s ramp-up typically takes about two to four weeks.
• Messaging limits (at the portfolio level) and throughput (at the phone-number level) are shared across providers on the same number.
• Review contracts and billing with your current provider. Message history may not transfer automatically.
• If you use separate support and marketing setups, see Integrations, data, and reporting and Using one number with more than one provider or workspace.

Connection paths

Current setup	Path
Number on another BSP; keep using that BSP and also send from Braze	Share the WhatsApp account with Braze through Embedded Signup. Recreate templates in your Braze Messaging account.
Number on another BSP; move sending fully to Braze	Share the WhatsApp account with Braze through Embedded Signup, then remove the other provider’s access in Meta when you’re ready.
Number on Braze native integration; move to Infobip billing	BYO WhatsApp connector (Infobip only)
Marketing on Braze and support on another provider	You can use separate numbers, or share one number across providers. For sharing behavior, see Using one number with more than one provider or workspace.

Connect through Embedded Signup

1. In Braze, start the Embedded Signup flow from the WhatsApp partner page.
2. When Meta prompts you, select the business portfolio and WhatsApp account that already hold your phone number, then grant Braze access.
3. Select the phone number you want Braze to use.
4. Complete Meta’s Embedded Signup workflow.

If Meta shows WhatsApp Business Account (WABA) labels, that may mean your business hasn’t migrated to Meta’s latest account model yet. Existing IDs and API field names such as waba_id continue to work. See WhatsApp accounts and Messaging accounts.

Development and production workspaces

Braze recommends separate Messaging accounts for development and production when possible:

• Use a dedicated test phone number in your sandbox or development workspace for integration testing.
• Keep your production phone number in your production workspace.
• If you need the same number in more than one workspace, connect it with a separate Messaging account in each workspace.
• Approve templates in the Messaging account tied to the workspace where you send. Template approvals apply per Messaging account.