WhatsApp Cloud API · error code

WhatsApp error 2388091 / 2388093: Phone number isn't eligible to receive or verify a registration code

ConfigurationOnboarding, migration & partner setup

Last verified against Meta for Developers - Cloud API error codes

What WhatsApp returns
This phone number isn’t eligible to receive/verify a registration code since it is not being migrated.

What error 2388091 / 2388093 means

Codes 2388091 and 2388093 share one row in Meta's error reference. The title says the phone number is not eligible to receive or verify a registration code because it is not being migrated, and the description adds that phone ownership verification APIs are not available for this use case. In other words, the code-based ownership check you attempted belongs to the migration path, and this number is not on that path.

Meta's listed resolution is to follow the solution-provider guide for registering and verifying business phone numbers. That guide describes four steps: create the number on the WABA, get a verification code, use the code to verify the number, and register it for API use. Embedded Signup performs the first three automatically unless you have disabled phone number selection or bypass the phone addition screen.

Two codes appear because Meta lists them together, one per half of the receive and verify pair. Treat them identically.

Why it happens

  • Running a migration runbook against a number that is not actually being migrated between accounts.
  • An earlier migration was abandoned, so the number is no longer in a migrating state.
  • Mixing steps from the migration flow and the standard registration flow for the same number.
  • Reusing onboarding code written for migrated numbers on brand-new numbers.

How to fix WhatsApp error 2388091 / 2388093

  1. 1Confirm whether this number is genuinely moving between WABAs or is a new addition.
  2. 2For a new addition, follow Meta's register-and-verify guide from the first step, creating the number with POST /<WABA_ID>/phone_numbers.
  3. 3Complete the code request and verification steps that guide describes for the new phone number ID.
  4. 4Register the verified number with POST /<PHONE_NUMBER_ID>/register and your six-digit PIN.

How to stop it recurring

Keep migration and new-number onboarding as two separate, clearly named code paths, and choose between them from recorded facts about where the number came from. Store which flow each number went through so later support tickets do not mix them up again.

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

Related codes

Error 2388091 / 2388093 - quick answers

What does WhatsApp error 2388091 / 2388093 mean?

Codes 2388091 and 2388093 share one row in Meta's error reference. The title says the phone number is not eligible to receive or verify a registration code because it is not being migrated, and the description adds that phone ownership verification APIs are not available for this use case. In other words, the code-based ownership check you attempted belongs to the migration path, and this number is not on that path.

How do I fix WhatsApp error 2388091 / 2388093?

1. Confirm whether this number is genuinely moving between WABAs or is a new addition. 2. For a new addition, follow Meta's register-and-verify guide from the first step, creating the number with POST /<WABA_ID>/phone_numbers . 3. Complete the code request and verification steps that guide describes for the new phone number ID. 4. Register the verified number with POST /<PHONE_NUMBER_ID>/register and your six-digit PIN.

Stop debugging WhatsApp by hand

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