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.
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.