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.
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.
Frequently asked questions
What's the difference between 2388091 and 2388093?+
How do I add a number that isn't being migrated?+
When is a number migration needed?+
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.