Log inStart Free Trial
Meta Tech Provider

Several WhatsApp Business app numbers in one business portfolio

One Meta business portfolio can hold several Coexistence numbers. Each number is its own WhatsApp Business app account on its own phone and goes through Embedded Signup separately. A new portfolio starts capped at two registered business phone numbers; Meta raises the cap to 20 once the business is verified or reaches a 2,000 messaging limit, and Direct Support handles requests beyond 20.

easyCoexistence connects each number through its own Embedded Signup run, monitors every one of them separately and lists them together in the dashboard and in list_numbers for your AI.

2

Registered business phone numbers a new business portfolio is initially capped at.

20

The cap Meta raises a portfolio to once the business is verified or reaches a 2,000 messaging limit.

2494067

Embedded Signup error when the business already created the maximum number of WhatsApp Business Accounts allowed.

20 mps

Fixed throughput of each number in use with both the WhatsApp Business app and Cloud API.

How do several numbers fit in one portfolio?

The business portfolio is the company container in Meta's business tools. It holds WhatsApp Business Accounts, and those hold phone numbers. With Coexistence, Embedded Signup does not create a partner-specific account: the number's Messaging account keeps its existing ID and stays associated with the client's own portfolio.

So a company with three branches, each answering on its own WhatsApp Business app number, ends up with three numbers under one portfolio, each still on its own phone. Every number keeps its own chats, its own quality rating, its own 20 messages per second and its own 14-day rule. The portfolio is where they meet: verification, the messaging limit and the number cap are counted there.

How many numbers can one portfolio hold?

Meta starts a new business portfolio at two registered business phone numbers. When the business becomes verified, or reaches a messaging limit of 2,000, Meta raises the cap to 20 automatically, sends a Meta Business Suite notification and fires a business_capability_update webhook with max_phone_numbers_per_business set to the new value.

Beyond 20, Meta's Embedded Signup error reference says to contact Direct Support to register more numbers across all of the portfolio's WhatsApp Business Accounts, or to delete a number first. A separate cap counts WhatsApp Business Accounts, not numbers; if signup stops at either one, the page on the portfolio limit error explains each code and how to free a slot.

How do you connect them one after another?

One Embedded Signup run per number. Each run picks the business portfolio, then the account and the number, and ends with a confirmation in the WhatsApp Business app on the phone that holds that number. Because every number sits on a different phone, the person with each phone has to be available for its own run; the browser part can be done by the same portfolio admin every time.

Pick the same portfolio on each run. Choosing a different one by mistake attaches the number somewhere else, and moving it later means disconnecting and onboarding again. Agencies connecting client branches usually send each branch its own connect link so the right phone confirms the right number.

What do the numbers share, and what stays separate?

Some decisions are made once for the portfolio and others belong to each number. Knowing which is which explains most surprises with multi-number setups. A template sent heavily from one branch moves only that number's quality rating, but the people it reaches count against the messaging limit every number in the portfolio shares. A block on adding phone numbers, RESTRICTED_ADD_PHONE_NUMBER_ACTION in Meta's account_update webhook, stops the whole rollout at once, while a ban on one number leaves its siblings sending.

Shared across the portfolioSeparate per number
LimitsMessaging limit, since October 2025Throughput, 20 messages per second
TrustBusiness verificationQuality rating and display name
EnforcementA block on adding phone numbersA ban on one number
ActivityNothing at portfolio levelThe 14-day rule, on each phone
ContentTemplates, within the same Business AccountChats, history and linked devices

Can one AI work across all the numbers?

Yes. Each number is its own connection, and a connector in ChatGPT or Claude sees all of them: ask your AI to run list_numbers, and it gets each number with the connection_id it passes to every other tool. "Send the opening hours template from the downtown number" names which one to use.

Automations are set per number, so one branch can have an after-hours reply while another hands chats to a booking system. An AI key is saved once per provider for the account and every AI-reply automation on any number uses it, with each number's chats kept apart in the AI's context.

Common mistakes

  • Connecting the second number into a different portfolio by accident. It splits verification and the messaging limit, and fixing it means onboarding again.
  • Expecting a template approved for one Business Account to appear on a number in another. Templates belong to the WhatsApp Business Account.
  • Adding numbers to an unverified portfolio and hitting the cap of 2 mid-rollout. Verify the business first if more than two numbers are planned.
  • Opening only the busiest branch's phone. The 14-day rule applies to each primary phone separately.
Doing this with EasyCoexistence

The price per number falls as the count grows: US$ 9 down to US$ 0.75 per number per month, falling as you add numbers, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

Does each number need its own phone?

Each Coexistence number is a WhatsApp Business app account with its own primary device, and Meta's 14-day rule and companion limits apply to that device separately.

Does a restriction on one number affect the others?

A ban on one number stays with that number. A restriction on the WhatsApp Business Account or the portfolio, such as a block on adding numbers, reaches every number under it.

How do I know my cap was raised?

Meta sends a Meta Business Suite notification and a business_capability_update webhook with max_phone_numbers_per_business set to the new cap.

Can numbers from different countries share one portfolio?

Meta's portfolio limits are about counts, not countries. Each number is checked on its own during Embedded Signup, including any regional refusal.

Keep reading

Ready to get started?

Set up WhatsApp Coexistence in minutes, not months. The app keeps working on the phone.

Start Free Trial

Verified on