Add Phone Number to Business Account
Changed onAdd 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
Request
- Base URLhttps://graph.facebook.com
- URLhttps://graph.facebook.com/{Version}/{Business-ID}/add_phone_numbers
- AuthHTTP bearer
Path parameters
Graph API version to use for this request. Determines the API behavior and available features.
Your WhatsApp Business Account ID. This ID can be found in your Business Manager or through business management APIs.
Headers
The user agent string identifying the client software making the request.
Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.
Request body
Example request
{
"phone_number": "+1234567890"
}Response
Phone number successfully added
Example response
{
"id": "1234567890123456"
}Changes
- breaking
added the new required request property
- breaking
removed the required property
from the response with the status - breaking
removed the required property
from the response with the status - breaking
removed the required property
from the response with the status - warning
removed the request property
- info
added the required property
to the response with the status
- breaking