Business Phone Numbers

Add Phone Number to Business Account

Changed on

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

Path parameters

Versionstring required

Graph API version to use for this request. Determines the API behavior and available features.

Business-IDstring required

Your WhatsApp Business Account ID. This ID can be found in your Business Manager or through business management APIs.

Headers

User-Agentstring
Example:Meta-Business-Messaging-OpenAPI/1.0.0;spec=2025-10-21

The user agent string identifying the client software making the request.

Authorizationstring required
Example:Bearer EAABwzLixnjYBOzYmNMJJGfHq9DgNh...

Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.

Request body

phone_numberstring 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.

Example request

{
  "phone_number": "+1234567890"
}

Response

Phone number successfully added

idstring required

Unique identifier for the preverified phone number entity that was created

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