---
title: "Add Phone Number to Business Account"
method: POST
path: "/{Version}/{Business-ID}/add_phone_numbers"
tags: ["Business Phone Numbers"]
---

# Add Phone Number to Business Account

`POST /{Version}/{Business-ID}/add_phone_numbers`

## Request

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

Add a preverified phone number to a WhatsApp Business Account. This endpoint is used by
Partners to create a pool of Partner owned numbers that end clients
can purchase.

**Use Cases:**
- Add new phone numbers to scale messaging operations
- Set up phone numbers for different business locations
- Manage phone number inventory for business messaging
- Configure phone numbers for specific messaging workflows

**Rate Limiting:**
Standard Graph API rate limits apply. Use appropriate retry logic with exponential backoff.

**Phone Number Requirements:**
- Must be in E.164 format (e.g., +1234567890)
- Must not be already registered to another WhatsApp Business Account
- Must be capable of receiving SMS for verification
- Must comply with WhatsApp's business messaging policies

## Path parameters

- `Version` string, required
- `Business-ID` string, required

## Headers

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

## Request body

- AddPhoneNumbersRequest: Request payload for adding a phone number to a business account
  - `phone_number` string, required: Phone number to add to the business account. Accepts E.164 format or formatted numbers with spaces, hyphens, and parentheses (e.g., +1234567890, +1 (631) 555-1000, +1-631-555-1000). The phone number will be normalized and validated by the endpoint.

## Response `200`

Phone number successfully added

- AddPhoneNumbersResponse: Response containing the ID of the successfully added phone number
  - `id` string, required: Unique identifier for the preverified phone number entity that was created

## Other responses

- `400`: Bad Request - Invalid parameters, malformed request, or phone number already registered
- `401`: Unauthorized - Invalid or missing access token
- `403`: Forbidden - Insufficient permissions or access denied
- `404`: Not Found - Business ID does not exist or is not accessible
- `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

## Changes

- **2025-11-07** (v23) `c7148d5e2aef`: 4 breaking, 1 warning, 1 info
  - added the new required request property `phone_number`
  - removed the required property `failed_count` from the response with the `200` status
  - removed the required property `phone_number_records` from the response with the `200` status
  - removed the required property `successful_count` from the response with the `200` status
  - …2 more

[Operation history](https://skmtc.dev/meta/apis/whatsapp-business-messaging/changes/:Version/:Business-ID/add_phone_numbers/post.md)

---

[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)