Skip to content
Meta Business PartnerAPI error reference

WhatsApp API error 2388012: phone number already in your account

Error 2388012 appears during a number migration: the number you're trying to bring in is already present in the WhatsApp Business Account you're migrating it to. There's nothing to migrate.

2388012
Code
Phone number already exists in your list of phone numbers
Meta's name
Migration and onboarding
Type
On a set-up call, not a send
Where you see it
No, don't resend
Retry

Quick answer

The number is already in your account. Don't migrate it again; register it (if it isn't registered) and use it from where it already is.

What WhatsApp error 2388012 means

Meta documents 2388012 as: this phone number already exists in your list of phone numbers, because the number you're trying to migrate is already present in your WhatsApp account. Its advice is to try again with a number that isn't already in the account.

Why error 2388012 happens

Onboarding and migration errors come from the state of the number or the account you're moving. Usually one of these:

  • A migration was run twice, and the first run already added the number.
  • The number was added manually before the migration started.
  • The wrong number was selected for migration.

How to fix error 2388012

There is no request change that gets this message delivered; the work is in your data and your audience.

  • List the phone numbers in the target account and find the existing entry.
  • Check whether that number is registered and able to send.
  • If it isn't registered, register it there instead of migrating.
  • If you meant to migrate a different number, start again with the right one.

Should you retry after 2388012?

Retrying the same migration keeps failing. Work with the number already in the account, or migrate a different number.

How error 2388012 shows up in InfiQ

This code belongs to set-up work rather than sending: templates, number registration or onboarding. When InfiQ's API makes that call for you, such as creating a template, the response carries Meta's error object (code 2388012, error_data.details) and an InfiQ_traceid; during registration or onboarding with InfiQ's team, pass the code and details to support.

Send it through InfiQ

Frequently asked questions

Does error 2388012 mean the migration failed?+
It means there was nothing to migrate, because the number is already in the account. Check its registration status and carry on from there.
Can the same number be in two WhatsApp Business Accounts?+
A number is used through one account at a time. Migration moves it; 2388012 tells you it's already where you're trying to move it.
What should I check after 2388012?+
Whether the existing entry is registered, has an approved display name and can send a test message. Those decide whether the number is ready to use.
Why would a migration run twice?+
Usually a retry after a timeout: the first attempt succeeded but its response was lost. Make migration steps check the number's current state before acting.