---
title: "Create WhatsApp Business Account Phone Number"
method: POST
path: "/{Version}/{WABA-ID}/phone_numbers"
tags: ["Phone Number Management"]
---

# Create WhatsApp Business Account Phone Number

`POST /{Version}/{WABA-ID}/phone_numbers`

## Request

- Base URL: `https://graph.facebook.com`
- URL: `https://graph.facebook.com/{Version}/{WABA-ID}/phone_numbers`
- Auth: HTTP bearer

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.

## Path parameters

- `Version` string, required
- `WABA-ID` string, required

## Headers

- `User-Agent` string
- `Authorization` string, required

## Request body

- PhoneNumberCreateRequest: Request payload for creating a new phone number registration
  - `phone_number` string, required: Phone number in E.164 format without the + prefix
  - `verified_name` string, required: Business name to be verified for this phone number
  - `cc` string: Country code for the phone number
  - `migrate_phone_number` boolean: Whether this is a phone number migration from on-premises
  - `preverified_id` string: Pre-verified phone number ID for BSP scenarios

## Response `200`

Successfully created phone number registration

- PhoneNumberCreateResponse: Response after successfully creating a phone number registration
  - `id` string, required: Unique identifier for the created phone number status record

## Other responses

- `400`: Bad Request - Invalid parameters or malformed request
- `401`: Unauthorized - Invalid or missing access token
- `403`: Forbidden - Insufficient permissions or phone number limit exceeded
- `404`: Not Found - WhatsApp Business Account ID does not exist or is not accessible
- `409`: Conflict - Phone number already exists or is in use
- `422`: Unprocessable Entity - Request parameters are valid but cannot be processed
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - Unexpected server error

---

[API](https://skmtc.dev/meta/apis/whatsapp-business-messaging.md) - [All operations](https://skmtc.dev/meta/apis/whatsapp-business-messaging/llms.txt) - [OpenAPI document](https://skmtc.dev/meta/apis/whatsapp-business-messaging/revisions/5c1973265369?raw)