WhatsApp connection and coexistence errors
Most errors you see while connecting a WhatsApp number come from Meta. Meta shows them in its own window, often with a code after a # sign, such as #2494064. Look up the code or the message below to find the fix.
Which error did I get with the WhatsApp Business app?
These errors appear when you connect or use a number with Keep using the Business app in Bird, also called coexistence. Connect your WhatsApp Business app number shows how the setup should go.
| What you see | Fix |
|---|---|
#2494064, #2388091, or #2655095, or no QR code appears | Meta says the number is already registered |
| Meta asks for a six-digit code | Meta asks for a six-digit verification code |
#3441034, not eligible to register or migrate | Meta says the number isn't eligible |
#3441055 | Deregistration is in progress |
#3441060 or #3441061 | A Business AI agent or automated events |
Another eligibility code, such as #3441045 or #2655094 | Meta reports an eligibility error |
#2655093, already sharing this WhatsApp Business account with a partner | Meta reports an eligibility error |
#4563039, missing Graph API permissions for Cloud API companion pairing | In Meta Business Suite, open the leftover WhatsApp Business App messaging account showing your number as Offline and choose Remove from business portfolio. If the account is still listed as disabled, remove it again. Wait 5 minutes, then connect again. See Missing pairing permissions. |
| Already in use by another account | Already in use by another account |
| Meta asks you to contact Bird B.V. after the QR code | Contact Bird B.V. after the QR code |
credit_currency_mismatch, or a message about billing currency | The number fails with a currency mismatch |
| Connected in the app, but the number is missing in Bird | The number isn't in Bird |
E15088, or the business profile can't be edited in Bird | Business profile changes return E15088 |
Which error did I get with another WhatsApp number?
These errors can appear with any number, whether or not it's in the WhatsApp Business app.
| What you see | Fix |
|---|---|
| CoEx gate evaluation is missing, or Meta asks to confirm it's you | Meta asks you to confirm it's you |
| Meta's signup finishes, but the number is missing from Bird | The number is missing from Bird |
| The number belongs to another business | The number belongs to another business |
#2494064, already registered to a WhatsApp account | The number is already registered |
This number is already connected to WhatsApp. (E15041) | Bird connects a WhatsApp number to one workspace at a time. If Numbers in this workspace lists the number, disconnect it there and connect it again. Otherwise, the number is connected in another Bird workspace, so disconnect it in that workspace first. |
1752358, Credit Allocation Not Allowed During Month-End Close | The number fails at the end of the month |
#2655121, #2655089, #3441040, or #2388107, account restricted | Your WhatsApp Business account is restricted |
| Your business is limited to 2 phone numbers | Why is my business limited to 2 phone numbers |
| Pre-verification fails | Why pre-verification fails |
Why don't messages show up in Conversations?
When you connect a number with Set up a number, Conversations is off until you turn it on. Open the number's Settings and turn on Enable conversations. Numbers connected with Keep using the Business app have it on from the start. Incoming messages don't appear in Conversations explains the setting.
What if my error isn't listed?
Contact support. Send the number, the code or message Meta showed, and when it happened. A screenshot of Meta's window helps.
Next steps
Related resources
Continue with the documentation, guides and examples for this topic.