Skip to main content
Waaru
WhatsApp Business API

WhatsApp embedded signup: choose your connection method

Tanay PatelAI and full-stack engineerUpdated 6 September 2026
The short answer

Embedded signup is Meta’s hosted flow for connecting a WhatsApp Business Account and number to business software. The steps depend on whether you have a new number, an existing Cloud API number, a provider-hosted number, or an eligible WhatsApp Business app number. Account access, verification, and sender eligibility determine what you can complete.

Before you connect a number, identify where it is used today and who owns the Meta account. This guide explains the connection choices. The linked Waaru guide gives you the exact dashboard steps.

What is embedded signup, exactly?

Meta hosts the account-selection and permission steps. Your platform starts the appropriate flow, then confirms the account and number you selected. A completed popup is one part of setup. Registration, account eligibility, templates, and message delivery may still need checks.

What do you need before you start?

  • A Meta login with access to the correct Business Portfolio and WhatsApp Business Account.
  • The number’s current connection: new, Cloud API, another provider, or WhatsApp Business app.
  • Access to any verification method requested for that path. Keep the Business app open when connecting an eligible app number.
  • Your business details and a clear record of which account owns the number.

The flow, step by step.

The platform starts the connection path for your number. Meta asks you to select the relevant business assets and approve permissions. The platform then confirms the exact account and number.

New-number setup, existing Cloud API access, provider migration, and Business app coexistence have different requirements. A two-step verification PIN is also different from an SMS or voice code. Follow the linked Waaru connection guide for the dashboard steps, then test inbound delivery and an eligible reply.

What goes wrong, and how to fix it?

  • Number already in use: check that you selected the correct connection path. Preserve the existing account and number while confirming migration or coexistence eligibility.
  • Missing account or number: confirm ownership, permissions, and the exact Meta login. For an existing Cloud API account, use that connection path rather than assuming a provider migration.
  • Verification code does not arrive: check the phone number and use another method if Meta offers one.
  • Display name or business eligibility issue: follow the specific Meta notice. Account age alone does not identify the cause.
  • Popup blocked: allow the Meta window for the platform domain and retry from the connection dialog.

What happens after signup?

Check the sender connection, inbound delivery, and an eligible reply. Confirm template approval before business-initiated sends. Business verification, display-name review, quality state, and messaging limits remain separate checks. Test consent, opt-outs, and the first workflow before sending a campaign.

FAQ

Frequently asked questions.

How long does WhatsApp embedded signup take?

There is no guaranteed completion time. The path depends on existing account access, number registration, verification, and Meta eligibility. Confirm connection and message delivery before treating the setup as complete.

Can I use my personal WhatsApp number for the API?

Personal WhatsApp and WhatsApp Business app numbers need different handling. Before changing or deleting an account, confirm the supported route for your number. Eligible Business app numbers may use the app connection path; a new business number is another option.

Does embedded signup cost anything?

Meta message charges and any software fees are separate from connecting an account. Waaru’s platform is free. Public signup is open. AI features are paid separately. Check Meta’s current rate card when budgeting messages.

Who owns the WABA after embedded signup?

Confirm that the selected account belongs to your business and review the permissions you grant. Moving providers can require migration steps and eligibility checks; it is not always a matter of running signup again.

Do I need business verification to start messaging?

Follow the eligibility and verification requirements shown for your account. Successful signup does not guarantee immediate messaging access, higher limits, or a verified badge. Check the sender state before sending.

Research notes

Evidence checked for this article.

  • Embedded signup creates/connects a WABA, registers the number via OTP, and grants the platform messaging permissions; WABA ownership remains with the business's Meta portfolio.

    Meta: WhatsApp embedded signup documentation · Accessed 4 July 2026

About the author

Tanay Patel

AI and full-stack engineer

Tanay builds production AI systems, agent workflows, and the full-stack software around them. His work focuses on reliable state, recovery, and human handoff.

Read Tanay's engineering notes

Put this into practice on your own number.

The platform is free. AI features are paid separately.