Embedded Sign-Up & Coexistence Onboarding Errors Troubleshooting Guide

Error: (#3441061) Automotive Events / Auto Labels Conflict

Error Message

Your phone number is already linked to automatic events. To use it for embedded sign-up, turn off Auto Labels in your WhatsApp Business App settings.

Cause

This error occurs when the phone number being onboarded has an existing Automotive Events / Auto Labels mapping associated with it.

The mapping may exist because:

• The number was previously connected through another BSP/provider.
• Auto Labels were previously enabled in WhatsApp Business App.

Solution A (Preferred)

Remove Auto Labels from WhatsApp Business App

1. Open WhatsApp Business App.

2. Navigate to:

   Settings → Business Tools → Labels

3. Locate any automatically created labels.

4. Delete the labels.

5. Retry Embedded Sign-Up.

Solution B (If Auto Labels Option Is Not Available)

If the user cannot find the Auto Labels setting and Solution A cannot be performed:

1. Completely disconnect the phone number from:
   • WhatsApp Business App
   • Any previous BSP/provider
   • Any ongoing Meta Embedded Sign-Up flow
2. Wait 15–30 minutes.
3. Retry onboarding.

---

Error: Existing WhatsApp Account

Error Message

This phone number is already registered with WhatsApp. To use this number, disconnect it from the existing WhatsApp account before onboarding.

Cause

This error occurs when the phone number is currently registered with WhatsApp Messenger or WhatsApp Business App.

Solution

Remove Existing Registration

1. Disconnect the phone number from WhatsApp Messenger or WhatsApp Business App.
2. Complete the deregistration process.
3. Retry onboarding.

---

Error: Existing SMB Account Conflict

Error Message

The phone number is linked to an existing WhatsApp Business account.

Cause

This error occurs when the phone number is already associated with another WhatsApp Business Account (WABA).

The number may already be:

• Connected to another WhatsApp Business Account.
• Registered through another Business Solution Provider (BSP).
• Under an incomplete migration process.

Solution

Disconnect or Migrate the Number

1. Identify the WhatsApp Business Account currently associated with the phone number.
2. Disconnect or migrate the phone number from the existing account.
3. Retry onboarding after the number becomes available.

---

Error: Two-Step Verification PIN Mismatch (#133005)

Error Message

Two-step verification PIN Mismatch.

Cause

This error occurs when the two-step verification PIN entered during registration does not match the PIN currently associated with the phone number.

Solution

Enter the Correct PIN

1. Enter the correct two-step verification PIN associated with the phone number.
2. Continue the registration process.

Reset the PIN

If the PIN is unknown:

1. Initiate the PIN reset process through WhatsApp.
2. Complete the verification process.
3. Retry registration after the PIN reset is completed.

---

Error: 2FA PIN Required

Error Message

A two-step verification PIN is required to complete registration.

Cause

This error occurs when two-step verification is already enabled on the phone number being registered.

Solution

Enter Existing PIN

1. Enter the existing two-step verification PIN.
2. Continue onboarding.

Reset PIN

If the PIN is unknown:

1. Reset the PIN through WhatsApp's recovery process.
2. Retry registration after the reset is completed.

---

Error: (#131042) Business Eligibility Payment Issue

Error Message

There was an error related to your payment method.

Cause

This error occurs when there is an issue with the payment configuration associated with the WhatsApp Business Account (WABA).

Possible causes include:

• Payment account is not attached to the WhatsApp Business Account.
• Credit limit has been exceeded.
• Credit line is inactive or not configured.
• WhatsApp Business Account is suspended or deleted.
• Currency or timezone settings are missing.
• Messaging request approval is pending or declined.
• Free conversation limit has been exceeded without a valid payment method.
• Tax information is missing.

Solution

Review Billing Configuration

1. Open WhatsApp Manager.
2. Navigate to Billing & Payments.
3. Verify that a valid payment method is attached.
4. Ensure the credit line is active.
5. Verify timezone and currency settings.
6. Resolve any account restrictions.
7. Retry onboarding after the billing issue is resolved.

---

Error: (#133016) Account Register/Deregister Rate Limit Exceeded

Error Message

Registration or Deregistration failed because there were too many attempts for this phone number in a short period of time.

Cause

This error occurs when the business phone number exceeds WhatsApp's registration or deregistration attempt limit.

Meta applies rate limits to prevent excessive registration activity.

Solution

Wait Until the Number Is Unblocked

1. Stop all registration and deregistration attempts.
2. Wait for the restriction period to expire.
3. Retry registration after the cooldown period.

---

Error: Existing PIN Protection

Error Message

A two-step verification PIN is already configured for this phone number.

Cause

This error occurs when two-step verification is already enabled on the phone number.

Solution

Enter Existing PIN

1. Enter the existing two-step verification PIN.
2. Continue registration.

Reset PIN

If the PIN is unknown:

1. Complete WhatsApp PIN recovery.
2. Retry registration after the PIN reset is completed.