WhatsApp API error 2388103: Cannot migrate phone number
Error 2388103 is one code with several messages, all about a number migration that can't go ahead. The message that comes with it tells you which situation you're in.
Quick answer
The migration was refused; the message says why. Most often the number doesn't need migrating at all, or its display name isn't approved yet.What WhatsApp error 2388103 means
Meta lists several messages under 2388103: phone number migration isn't supported for accounts on the new WhatsApp account model; the number can be added directly and doesn't need the migration APIs; the number needs an approved display name with no pending change; a general error while migrating, where you should try again later or contact support; and several account checks that Meta marks as not applicable under the new model.
Why error 2388103 happens
Onboarding and migration errors come from the state of the number or the account you're moving. Usually one of these:
- Trying to migrate a number that is eligible to be added directly.
- The number's display name isn't approved, or a display name change is pending.
- The accounts are on the new WhatsApp account model, where migration isn't supported.
- A temporary failure during the migration itself.
How to fix error 2388103
Work through these in order; the first one that turns up a problem is usually the fix.
- Read the exact message returned with 2388103.
- If it says the number can be added directly, register and verify it instead of migrating.
- If it mentions the display name, get the name approved and clear any pending change first.
- If it's a general migration error, wait and try again, then contact support with the details.
Should you retry after 2388103?
Only the general migration error is worth retrying later. For the other messages, change the approach: add the number directly or fix the display name.
How error 2388103 shows up in InfiQ
Error 2388103 comes from a set-up call, not a message send: creating or changing a template, registering a number or onboarding an account. InfiQ's template endpoints return Meta's error object for it with an InfiQ_traceid; for number registration and onboarding, which InfiQ's team runs with you, share the code and the details text with support.
Frequently asked questions
Why does Meta say migration isn't supported for my account?+
Does my display name need to be approved to migrate?+
Is 2388103 ever temporary?+
Move your number to InfiQ with help
InfiQ's team handles number registration and migration with you, and explains any Meta error on the way.