Skip to main content

​
WhatsApp Business Pre-Verified Phone Number Sharing API

Copy for LLM View as Markdown Version v23.0 API for sharing WhatsApp Business Pre-Verified Phone Numbers between business entities, enabling collaborative phone number management and partnership workflows. This endpoint allows authorized businesses to share pre-verified phone numbers with partner businesses, facilitating multi-business WhatsApp integrations while maintaining proper access controls and ownership boundaries. Shared phone numbers can be used by partner businesses for WhatsApp Business messaging operations.

​
Base URL

| https://graph.facebook.com |

​
Endpoints

| POST | ///share_preverified_numbers |

​
POST ///share_preverified_numbers

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

​
Request Syntax

POST///share_preverified_numbers Try it Select language cURLJavaScriptPython 
curl --request POST \
  --url 'https://graph.facebook.com/{Version}/{Business-ID}/share_preverified_numbers' \
  --header 'Authorization: Bearer <Token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "preverified_id": "1234567890123456",
  "partner_business_id": "9876543210987654"
}'
Select status code 200400401403404422429500 
\{
  "successful_sharing": {
    "summary": "Successful phone number sharing operation",
    "value": {
      "success": true
    }
  }
}
Header Parameters
User-Agentstring The user agent string identifying the client software making the request. Authorizationstring·required Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token. 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. Request BodyRequired
Phone number sharing configuration and target business details Content Type: application/json Schema: PreVerifiedPhoneNumberShareRequest Show child attributes
PreVerifiedPhoneNumberShareRequest
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. Responses
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 200 Successfully shared pre-verified phone number with target business Content Type: application/json Schema: PreVerifiedPhoneNumberShareResponse Show child attributes
PreVerifiedPhoneNumberShareResponse
successboolean·required Indicates whether the sharing operation was successful 400 Bad Request - Invalid parameters or malformed request Content Type: application/json Schema: GraphAPIError Show child attributes
GraphAPIError
errorobject·required Show child attributes
messagestring·required Human-readable error message
typestring·required Error category type
codeinteger·required Numeric error code
error_subcodeinteger More specific error subcode when available
fbtrace_idstring Unique identifier for debugging and support requests with Meta
is_transientboolean Indicates whether this error is temporary and the request should be retried
error_user_titlestring User-friendly error title for display purposes
error_user_msgstring User-friendly error message for display purposes 401 Unauthorized - Invalid or missing access token Content Type: application/json Schema: GraphAPIError Show child attributes
GraphAPIError
errorobject·required Show child attributes
messagestring·required Human-readable error message
typestring·required Error category type
codeinteger·required Numeric error code
error_subcodeinteger More specific error subcode when available
fbtrace_idstring Unique identifier for debugging and support requests with Meta
is_transientboolean Indicates whether this error is temporary and the request should be retried
error_user_titlestring User-friendly error title for display purposes
error_user_msgstring User-friendly error message for display purposes 403 Forbidden - Insufficient permissions or access denied Content Type: application/json Schema: GraphAPIError Show child attributes
GraphAPIError
errorobject·required Show child attributes
messagestring·required Human-readable error message
typestring·required Error category type
codeinteger·required Numeric error code
error_subcodeinteger More specific error subcode when available
fbtrace_idstring Unique identifier for debugging and support requests with Meta
is_transientboolean Indicates whether this error is temporary and the request should be retried
error_user_titlestring User-friendly error title for display purposes
error_user_msgstring User-friendly error message for display purposes 404 Not Found - Resource does not exist or is not accessible Content Type: application/json Schema: GraphAPIError Show child attributes
GraphAPIError
errorobject·required Show child attributes
messagestring·required Human-readable error message
typestring·required Error category type
codeinteger·required Numeric error code
error_subcodeinteger More specific error subcode when available
fbtrace_idstring Unique identifier for debugging and support requests with Meta
is_transientboolean Indicates whether this error is temporary and the request should be retried
error_user_titlestring User-friendly error title for display purposes
error_user_msgstring User-friendly error message for display purposes 422 Unprocessable Entity - Request parameters are valid but cannot be processed Content Type: application/json Schema: GraphAPIError Show child attributes
GraphAPIError
errorobject·required Show child attributes
messagestring·required Human-readable error message
typestring·required Error category type
codeinteger·required Numeric error code
error_subcodeinteger More specific error subcode when available
fbtrace_idstring Unique identifier for debugging and support requests with Meta
is_transientboolean Indicates whether this error is temporary and the request should be retried
error_user_titlestring User-friendly error title for display purposes
error_user_msgstring User-friendly error message for display purposes 429 Too Many Requests - Rate limit exceeded Content Type: application/json Schema: GraphAPIError Show child attributes
GraphAPIError
errorobject·required Show child attributes
messagestring·required Human-readable error message
typestring·required Error category type
codeinteger·required Numeric error code
error_subcodeinteger More specific error subcode when available
fbtrace_idstring Unique identifier for debugging and support requests with Meta
is_transientboolean Indicates whether this error is temporary and the request should be retried
error_user_titlestring User-friendly error title for display purposes
error_user_msgstring User-friendly error message for display purposes 500 Internal Server Error - Unexpected server error Content Type: application/json Schema: GraphAPIError Show child attributes
GraphAPIError
errorobject·required Show child attributes
messagestring·required Human-readable error message
typestring·required Error category type
codeinteger·required Numeric error code
error_subcodeinteger More specific error subcode when available
fbtrace_idstring Unique identifier for debugging and support requests with Meta
is_transientboolean Indicates whether this error is temporary and the request should be retried
error_user_titlestring User-friendly error title for display purposes
error_user_msgstring User-friendly error message for display purposes Select language cURLJavaScriptPython 
curl --request POST \
  --url 'https://graph.facebook.com/{Version}/{Business-ID}/share_preverified_numbers' \
  --header 'Authorization: Bearer <Token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "preverified_id": "1234567890123456",
  "partner_business_id": "9876543210987654"
}'
Select status code 200400401403404422429500 
\{
  "successful_sharing": {
    "summary": "Successful phone number sharing operation",
    "value": {
      "success": true
    }
  }
}

​
Authentication

| Scheme | Type | Location | | bearerAuth | HTTP Bearer | Header: Authorization |

​
Usage Examples

bearerAuth: Include Authorization: Bearer your-token-here in request headers

​
Global Authentication Requirements

All endpoints require: bearerAuth Did you find this page helpful? Thumbs up icon Thumbs down icon