---
title: "Share Pre-Verified Phone Number with Another Business"
method: POST
path: "/{Version}/{Business-ID}/share_preverified_numbers"
tags: ["Pre-Verified Phone Number Sharing"]
---

# Share Pre-Verified Phone Number with Another Business

`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

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

## Path parameters

- `Version` string, required
- `Business-ID` string, required

## Headers

- `User-Agent` string
- `Authorization` string, required

## Request body

- PreVerifiedPhoneNumberShareRequest: Request payload for sharing a pre-verified phone number with another business
  - `preverified_id` string, 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_id` string, 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.

## Response `200`

Successfully shared pre-verified phone number with target business

- PreVerifiedPhoneNumberShareResponse: Response containing details of the successful phone number sharing operation
  - `success` boolean, required: Indicates whether the sharing operation was successful

## Other responses

- `400`: Bad Request - Invalid parameters or malformed request
- `401`: Unauthorized - Invalid or missing access token
- `403`: Forbidden - Insufficient permissions or access denied
- `404`: Not Found - Resource does not exist or is not accessible
- `422`: Unprocessable Entity - Request parameters are valid but cannot be processed
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - Unexpected server error

## Changes

- **2025-11-07** (v23) `c7148d5e2aef`: 5 breaking, 9 warning, 1 info
  - added the new required request property `partner_business_id`
  - added the new required request property `preverified_id`
  - removed the required property `shared_at` from the response with the `200` status
  - removed the required property `sharing_id` from the response with the `200` status
  - …11 more

[Operation history](https://skmtc.dev/meta/apis/whatsapp-business-messaging/changes/:Version/:Business-ID/share_preverified_numbers/post.md)

---

[API](https://skmtc.dev/meta/apis/whatsapp-business-messaging.md) - [All operations](https://skmtc.dev/meta/apis/whatsapp-business-messaging/llms.txt) - [OpenAPI document](https://skmtc.dev/meta/apis/whatsapp-business-messaging/revisions/5c1973265369?raw)