Share Pre-Verified Phone Number with Another Business
Changed onShare 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
Request
- Base URLhttps://graph.facebook.com
- URLhttps://graph.facebook.com/{Version}/{Business-ID}/share_preverified_numbers
- AuthHTTP bearer
Path parameters
Graph API version to use for this request. Determines the API behavior and available features.
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
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
{
"preverified_id": "1234567890123456",
"partner_business_id": "9876543210987654"
}Response
Successfully shared pre-verified phone number with target business
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
- breaking