Pre-Verified Phone Number Sharing

Share Pre-Verified Phone Number with Another Business

Changed on

Share a pre-verified phone number with another business entity, granting specified permissions for collaborative WhatsApp Business messaging operations.

Use Cases:

  • Enable partner businesses to use your pre-verified phone numbers for messaging
  • Share phone number resources between parent and subsidiary businesses
  • Facilitate multi-business WhatsApp integrations with shared phone number access
  • Establish temporary or permanent phone number sharing relationships

Business Logic:

  • Only businesses with appropriate ownership or sharing rights can share phone numbers
  • Shared phone numbers maintain original ownership while granting usage permissions
  • Multiple businesses can have access to the same phone number with different permission levels
  • Sharing relationships can be time-limited with automatic expiration

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

Validation:

  • Pre-verified phone number must exist and be accessible to the requesting business
  • Target business must be a valid and accessible business entity
  • Requested permissions must be valid and within the scope of allowed sharing permissions
  • Sharing operation must comply with business relationship and access control policies
post/{Version}/{Business-ID}/share_preverified_numbers

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{Business-ID}/share_preverified_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 Business ID that owns or has sharing rights to the pre-verified phone number. This ID can be found in your Meta 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

preverified_idstring required

Unique identifier of the pre-verified phone number to be shared. Must be a valid phone number ID that the requesting business owns or has sharing rights to.

partner_business_idstring required

Business ID of the partner business that will receive access to the pre-verified phone number. Must be a valid business entity accessible to the requesting app.

Example request

{
  "preverified_id": "1234567890123456",
  "partner_business_id": "9876543210987654"
}

Response

Successfully shared pre-verified phone number with target business

successboolean required

Indicates whether the sharing operation was successful

Example response

{
  "success": true
}

Changes

    • breaking

      added the new required request property

    • 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

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the required property to the response with the status