Platform
Chatbot Builder Bulk Messaging Team Inbox Mini CRM API & Webhooks AI Integration WhatsApp Flows
Industries
E-commerce & D2C Real Estate Education Healthcare Finance & BFSI Logistics Hospitality Retail
Integrations
Learn
Learning Hub Help & Docs Connect Guides Automation Codex Blog Message Templates
Pricing Log in to Dashboard Get Started →
Home › Help & Docs › Troubleshooting › Number migration or registration failed
Troubleshooting

Number migration or registration failed

Registration or migration can fail for a few predictable reasons. Work through these before retrying.

Common causes

The number is still attached to another provider, so Meta will not move it. The two-factor PIN is wrong or unknown. The number is still on the WhatsApp app, so it cannot register fresh. Or the OTP step did not complete.

Fix it

1
If migrating, release the number at the current provider first.
2
If the number is on the WhatsApp or WhatsApp Business app, delete that account and wait two hours before registering.
3
If you do not know the 2FA PIN, reset it from Meta's WhatsApp Manager, then retry.
4
Re-run registration and complete the OTP verification by call or text.
The two-hour rule

After deleting a number from the WhatsApp app, wait a full two hours before registering it on the API, or registration will fail.

Still stuck? Message us and a real person will help, the only platform in India that answers you live on WhatsApp.

Ask us on WhatsApp
More in Troubleshooting

Number stuck on Pending

If your number stays on Pending after registration, the cause is almost always a…

Template was rejected

Meta reviews every template and can reject one. The reasons are usually…

Bot is not triggering or replying

If a bot is not starting or replying, the cause is almost always one of a short list.…

Messages are not delivering

When messages do not reach customers, the cause is usually the messaging rules rather…

View all 15 articles in Troubleshooting →
Want the bigger picture? See the delivery troubleshooting guide for use cases and strategy.
Read more →
1