WhatsApp Cloud API · error code

WhatsApp error 2388103: Cannot migrate phone number

ConfigurationOnboarding, migration & partner setup

Last verified against Meta for Developers - Cloud API error codes

What WhatsApp returns
Cannot migrate phone number.

What error 2388103 means

Code 2388103 is an umbrella for phone migration refusals, and the text that comes with it tells you which one you hit. Meta's reference lists several variants. The display name variant, "Registered name should be present and approved.", means the number needs a display name with name_status of APPROVED and no pending display name change. "Please add this phone number in your WhatsApp account" means the number is eligible to be added directly and does not need the migration APIs at all. "There was an error migrating this phone number." is a transient failure: try again later and contact support if it persists.

Several other variants (account not set up correctly, no payment account, number belongs to a different Business Manager, account or "Messaging For" request must be approved, and the bare "Cannot migrate phone number.") carry the same note: phone number migration isn't supported for accounts on the new WhatsApp account model. For those, Meta lists no workaround.

What it looks like

2388103 - Cannot migrate phone number.
2388103 - Please add this phone number in your WhatsApp account
2388103 - Registered name should be present and approved.
2388103 - There was an error migrating this phone number.
2388103 - This phone number belongs to a different Business Manager account.
2388103 - Your WhatsApp account does not have a payment account.

Why it happens

  • The number's display name is not approved, or a display name change is pending.
  • Using migration for a number that can simply be added and registered.
  • The source or destination account is on the new WhatsApp account model, where migration is not supported.
  • A temporary failure on Meta's side during the migration request.

How to fix WhatsApp error 2388103

  1. 1Read the exact message returned with 2388103 and match it to the variant.
  2. 2For the display name variant, get the name approved and clear pending changes, then retry.
  3. 3For "Please add this phone number", follow the normal add, verify, and register flow instead.
  4. 4For the generic error, wait and retry; open a support case if it keeps failing.
  5. 5For variants Meta marks as unsupported on the new account model, stop retrying and escalate through Meta support.

How to stop it recurring

Before starting any migration, check the number's name_status, whether it is eligible to be added directly, and which account model the WABAs use. Log the full 2388103 message every time, since the code alone is ambiguous and the variant decides whether to retry, fix, or escalate.

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

Related codes

Error 2388103 - quick answers

What does WhatsApp error 2388103 mean?

Code 2388103 is an umbrella for phone migration refusals, and the text that comes with it tells you which one you hit. Meta's reference lists several variants. The display name variant, "Registered name should be present and approved.", means the number needs a display name with name_status of APPROVED and no pending display name change.

How do I fix WhatsApp error 2388103?

1. Read the exact message returned with 2388103 and match it to the variant. 2. For the display name variant, get the name approved and clear pending changes, then retry. 3. For "Please add this phone number", follow the normal add, verify, and register flow instead. 4. For the generic error, wait and retry; open a support case if it keeps failing. 5. For variants Meta marks as unsupported on the new account model, stop retrying and escalate through Meta support.

Stop debugging WhatsApp by hand

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