Skip to content
Meta Business PartnerAPI error reference

WhatsApp API errors 2388091 and 2388093: number isn't being migrated

Errors 2388091 and 2388093 come from the code-request and code-verification steps used for moving numbers. They mean those steps don't apply, because this number isn't in a migration.

2388091, 2388093
Codes
Number isn't being migrated
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 number isn't being migrated, so the migration code steps don't apply. Register and verify it the normal way instead.

What WhatsApp error 2388091 means

Meta documents 2388091 and 2388093 as: this phone number isn't eligible to receive or verify a registration code since it is not being migrated. It adds that the phone ownership verification APIs aren't available for this use case, and that you should register and verify the number.

Why error 2388091 happens

Onboarding and migration errors come from the state of the number or the account you're moving. Usually one of these:

  • Using migration-specific steps for a number that's simply being added.
  • The migration was never started, or was cancelled, before requesting the code.
  • Following a migration guide for a number that doesn't need migrating.
  • Migration steps copied into a script for setting up brand-new numbers.

How to fix error 2388091

Work through these in order; the first one that turns up a problem is usually the fix.

  • Decide whether the number is being migrated from another account or added fresh.
  • If it's being added, register and verify it the normal way.
  • If it really is a migration, start the migration first, then request and verify the code.
  • Check the number's status in the target account afterwards.
  • Keep migration and new-number procedures clearly separate in your runbooks.

Should you retry after 2388091?

Repeating the migration steps keeps failing. Switch to normal registration and verification, or start the migration properly first.

How error 2388091 shows up in InfiQ

Error 2388091 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

What's the difference between 2388091 and 2388093?+
Meta groups them: one refers to receiving a registration code and the other to verifying it. Both mean the number isn't in a migration, so those steps don't apply.
How do I add a number that isn't being migrated?+
Add it to the WhatsApp Business Account, verify ownership with a code by SMS or voice, and register it with a two-step PIN.
When is a number migration needed?+
When the number is already registered with the API in another WhatsApp Business Account and you want to move it without losing its set-up.