Skip to content
Meta Business PartnerAPI error reference

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.

2388103
Code
Cannot migrate phone number
Meta's name
Migration and onboarding
Type
On a set-up call, not a send
Where you see it
After fixing the cause
Retry

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.

Send it through InfiQ

Frequently asked questions

Why does Meta say migration isn't supported for my account?+
Meta's messages for 2388103 say phone number migration isn't supported for accounts on the new WhatsApp account model. In that case, add and register the number directly.
Does my display name need to be approved to migrate?+
Yes, for migration. Meta's message says the business phone number must have an approved display name and no pending display name change requests.
Is 2388103 ever temporary?+
One of its messages is a general error while migrating; for that one, Meta suggests trying again after some time and contacting support if it keeps failing.