Create a new phone number registration within a WhatsApp Business Account. This endpoint initiates the phone number onboarding process, including verification and business name approval.

Use Cases:

• Add new phone numbers to a WhatsApp Business Account
• Migrate phone numbers from on-premises to Cloud API
• Register pre-verified phone numbers for BSP scenarios
• Initiate phone number verification and business name approval process

Prerequisites:

• WhatsApp Business Account must have available phone number slots
• Phone number must not be already registered with WhatsApp Business
• Business must meet WhatsApp Business API requirements
• Appropriate permissions and app review completion

Process Flow:

1. Submit phone number and business name for registration
2. Phone number verification code will be sent (if not pre-verified)
3. Business name will be submitted for review
4. Monitor status through GET endpoint until approval

Rate Limiting: Phone number creation is subject to strict rate limits to prevent abuse. Standard Graph API rate limits also apply.

Migration Support: Set migrate_phone_number=true when migrating from on-premises API to Cloud API. Additional validation and migration-specific logic will be applied.

{
  "phone_number": "16315551000",
  "verified_name": "My Business Name",
  "cc": "1",
  "preverified_id": "preverified_12345"
}

{
  "id": "1906385232743451"
}