WhatsApp Cloud API · error code

WhatsApp error 2388012: This phone number already exists in your list of phone numbers.

ConfigurationOnboarding, migration & partner setup

Last verified against Meta for Developers - Cloud API error codes

What WhatsApp returns
The phone number you are trying to migrate is already present in your WhatsApp account.

What error 2388012 means

Code 2388012 is a phone migration error. You asked to migrate a business phone number into a WhatsApp Business Account that already lists that same number, so there is nothing to move. Meta's guidance is simply to try again with a number that is not already present in the account.

The usual story is a retry. A first migration attempt partly succeeded, or someone added the number through WhatsApp Manager or Embedded Signup while a script was preparing its own migration call, and the second attempt collides with the first. It also appears when a team keeps one staging and one production WABA and loses track of which one already holds the number.

The error does not mean the number is registered or ready to send. Being listed in the account and being registered on Cloud API are separate states, so check the number's status before assuming the earlier attempt finished.

What it looks like

{
  "error": {
    "code": 2388012,
    "error_data": {
      "messaging_product": "whatsapp",
      "details": "The phone number you are trying to migrate is already present in your WhatsApp account."
    }
  }
}

Why it happens

  • Running the migration request a second time after a timeout on the first.
  • The number was already added to this WABA by another person or tool.
  • Pointing the migration at the destination WABA that the number moved to last time.
  • Confusing staging and production WABAs that share a business portfolio.

How to fix WhatsApp error 2388012

  1. 1List the WABA's numbers with GET /<WABA_ID>/phone_numbers and look for the number.
  2. 2If it is present, skip the migration call and check its verification and registration status instead.
  3. 3If the number should live in a different WABA, run the process against that account.
  4. 4Once listed, complete registration so it can send (see 133010 if it is still unregistered).

How to stop it recurring

Make migration idempotent: before calling the migration endpoint, check whether the destination WABA already lists the number and branch accordingly. Record each migration attempt with its WABA ID and outcome so a retry after a timeout starts from facts rather than guesswork.

Official reference: Meta for Developers - Cloud API error codes. See all WhatsApp error codes or the WhatsApp limits and quotas.

Related codes

Error 2388012 - quick answers

What does WhatsApp error 2388012 mean?

Code 2388012 is a phone migration error. You asked to migrate a business phone number into a WhatsApp Business Account that already lists that same number, so there is nothing to move. Meta's guidance is simply to try again with a number that is not already present in the account. The usual story is a retry.

How do I fix WhatsApp error 2388012?

1. List the WABA's numbers with GET /<WABA_ID>/phone_numbers and look for the number. 2. If it is present, skip the migration call and check its verification and registration status instead. 3. If the number should live in a different WABA, run the process against that account. 4. Once listed, complete registration so it can send (see 133010 if it is still unregistered).

Stop debugging WhatsApp by hand

Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.