Skip to main content
    Back to Documentation
    Troubleshooting

    WhatsApp Error: Phone Number Already Registered with INBOX Product

    Fix the WhatsApp error 'This phone number is already registered with the INBOX product' by disconnecting the existing partner before onboarding with a new platform.

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

    WhatsApp Error: Already Registered with INBOX

    This error occurs when your phone number is already connected to another WhatsApp Business API provider and needs to be disconnected before connecting to a new platform.

    Error Message

    "This phone number is already registered with the INBOX product"

    Why This Happens

    Each WhatsApp Business API phone number can only be connected to one platform at a time. This error occurs when:

  1. The number is connected to another Business Solution Provider (BSP)
  2. A previous integration wasn't properly disconnected
  3. The number is still linked to a test or demo account

    4. How to Fix This Error

    Step 1: Disconnect from the Existing Partner

    1. Open the WhatsApp Business App on your phone

    2. Go to Settings > Account

    3. Tap Business Platform or Linked Devices

    4. Find the currently connected partner/platform

    5. Tap Disconnect

    6. Confirm the disconnection

    Step 2: Wait for Propagation

    After disconnecting:

  4. Wait 5-10 minutes for the change to propagate
  5. WhatsApp's systems need time to update

    6. Step 3: Perform New Onboarding

    1. Return to your new platform (Envoy)

    2. Start the onboarding process

    3. The number should now be available for connection

    If You Don't Have Access to the Old Platform

    If you can't access the previous provider:

    1. Try disconnecting through the WhatsApp Business App

    2. Contact the previous provider to request disconnection

    3. Reach out to Meta support if necessary

    Prevention Tips

  6. Always properly disconnect before switching providers
  7. Keep records of which platforms are connected
  8. Document your integration setup for team reference

    9. Need Help?

    If you're unable to disconnect from the previous provider:

    Tell us what you need — Our team can help with the migration process.

    Previous
    WhatsApp Error: Phone Number Not Eligible to Connect to Business Platform
    Next
    WhatsApp Disconnection: Messages Are Now End-to-End Encrypted Warning