Skip to main content
    Back to Documentation
    Troubleshooting

    WhatsApp Error: Phone Number Not Eligible to Connect to Business Platform

    Fix the WhatsApp error 'Your phone number is not eligible to connect to the WhatsApp Business Platform' by increasing app activity and recreating your account before onboarding.

    2 min read
    Updated Jan 16, 2025
    errornot eligiblephone numberonboardingbusiness platformtroubleshooting
    Using Envoy? See the Envoy-specific guide with step-by-step instructions for your dashboard.

    WhatsApp Error: Phone Number Not Eligible

    This error occurs when WhatsApp's systems cannot verify the eligibility of your phone number for the Business Platform.


    Error Message

    "Your phone number is not eligible to connect to the WhatsApp Business Platform."

    Why This Happens

    WhatsApp requires phone numbers to meet certain eligibility criteria:

  1. Sufficient activity history on WhatsApp
  2. Valid phone number registration
  3. No previous violations or bans
  4. Proper verification status
  5. New or inactive numbers often trigger this error.


    How to Fix This Error

    Step 1: Increase WhatsApp Business App Activity

    More activity on the WhatsApp Business App helps WhatsApp determine eligibility:

    1. Use the WhatsApp Business App regularly

    2. Send and receive messages

    3. Update your business profile

    4. Add products to your catalog

    5. Continue normal business activity for a few days

    Step 2: Delete and Recreate the Account

    After building activity:

    1. Open the WhatsApp Business App

    2. Go to Settings > Account > Delete Account

    3. Confirm the deletion

    4. Recreate a new WhatsApp Business Account with the same number

    5. Set up your business profile again

    Step 3: Retry Onboarding

    After recreating the account:

    1. Return to your WhatsApp Business API platform (Envoy)

    2. Attempt the onboarding process again

    3. The eligibility check should now pass


    How Long to Wait

    Typically, a few days of normal WhatsApp Business App usage is sufficient to establish eligibility. In some cases, it may take up to 2 weeks.


    Prevention Tips

  6. Use the WhatsApp Business App actively before API migration
  7. Maintain a good messaging reputation
  8. Complete business profile setup fully
  9. Avoid spam-like behaviour

  10. Need Help?

    If your number remains ineligible after following these steps:

    Tell us what you need — Our team can help troubleshoot eligibility issues.