Device Manager
Cloud API Errors
Common errors during WhatsApp Cloud API signup and how to fix them.
When you connect a device using Cloud API, ReplyLa opens Meta's Embedded Signup window. Most connection problems happen inside this window, not in ReplyLa itself. This page lists the errors you may see and how to fix them.
This page covers Cloud API signup only. Connecting through Meta Coexistence instead? See Coexistence Issues.
The signup process has four stages, and errors usually fall into one of them:
- Business Manager account - creating or selecting a Meta Business account.
- WhatsApp Business Account (WABA) - creating the WhatsApp account.
- Phone setup - adding your phone number.
- Phone verification - confirming the number with a code.
Business Manager Account Errors
| Error | What It Means | How To Fix |
|---|---|---|
| "An error occurred while processing this request" | A general processing failure. | Use an active Facebook account. If it keeps happening, contact support. |
| Business creation limit reached | Meta limits how many Business Manager accounts one user can create. | Use an existing Business account, or delete unused ones. |
| "Your Facebook account is too new" | New accounts can't create a Business account right away. | Wait a few hours, or use an older, established Facebook account. |
| Account flagged for unusual activity | Meta detected suspicious activity on the account. | Switch to a Facebook account in good standing. |
| "You're no longer allowed to use Facebook Products to advertise" | The Facebook account has advertising restrictions. | Use a Facebook account with no restrictions. |
| Payment account disabled | The linked payment account was disabled for suspected violations. | Contact Meta Support to restore the account. |
| "A user can only create one business user at one time" | You're trying to create two Business accounts at once. | Use an existing Business Manager account instead. |
| Invalid business name | The business name breaks Meta's naming rules. | Rename it following Meta's business naming guidelines. |
WhatsApp Business Account Errors
| Error | What It Means | How To Fix |
|---|---|---|
| Missing admin permissions | You don't have admin access to the selected Business account. | Ask for admin rights, or pick a Business account you already manage. |
| Verification required | Meta limits how many WhatsApp accounts you can create before verification. | Complete business verification in Business Manager first. |
| Account verification failed | The Business account doesn't meet WhatsApp API requirements. | Check your verification status, review Meta's rejection email, and resubmit. |
| Generic system error | A temporary issue on Meta's side. | Wait a few minutes and retry the signup. |
Phone Setup Errors
| Error | What It Means | How To Fix |
|---|---|---|
| "This phone number already exists in your list" | The number is already added to your account. | Restart the flow and select the existing number instead of adding it again. |
| Number already registered with WhatsApp | The number is in use on WhatsApp Messenger, the Business App, or another API. | Deregister it from the existing app, or use a different number. |
| "Your verified name violates WhatsApp guidelines" | The display name breaks WhatsApp's rules. | Update the business name to follow WhatsApp display name policies. |
| Profile configuration issue | Business profile details are incomplete or invalid. | Re-enter your profile information following WhatsApp's standards. |
Phone Verification Errors
| Error | What It Means | How To Fix |
|---|---|---|
| Number already verified | The number is verified but the status hasn't refreshed. | Refresh the page to update the verification status. |
| "Your phone number doesn't appear to be valid" | The number format or provider isn't supported. | Confirm the number is correct and supported by a valid telecom provider. |
| "You have guessed too many times" | Too many wrong verification codes were entered. | Wait 12 hours before trying again. |
| Verification failed | Network issues, system delays, or a request timeout. | Wait a moment and retry the verification. |
| "You have requested your code too many times" | You asked for a new code too often. | Wait for the cooldown period before requesting another code. |
Try the signup in an incognito/private browser window while logged into the correct Facebook account. This avoids conflicts with other Facebook sessions and is the fastest fix for many signup errors.
Still Stuck?
If an error keeps appearing after trying these fixes, contact ReplyLa support. Include the exact error message and a screenshot of the signup window - this helps us resolve it faster.
Common Questions
No. These errors come from Meta's Embedded Signup process, which ReplyLa uses to connect WhatsApp via Cloud API. The fixes are made in your Facebook or Business Manager account.
Meta flags accounts that are very new or show unusual activity. Using an established Facebook account in good standing avoids most of these issues.
A number can only be active on one WhatsApp setup at a time. Deregister it from the WhatsApp app first, or use Meta Coexistence if you want to keep using the app.