Pre-Verified Phone Numbers

Delete Pre-Verified Phone Number

Delete a pre-verified phone number from the system. This operation removes the phone number from your pre-verified list and cannot be undone.

Use Cases:

  • Remove phone numbers that are no longer needed
  • Clean up invalid or incorrect pre-verified phone numbers
  • Manage phone number lifecycle and cleanup

Important Notes:

  • This operation is irreversible
  • Deleted phone numbers cannot be recovered
  • Ensure the phone number is not in active use before deletion

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

delete/{Version}/{Pre-Verified-Phone-Number-ID}

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{Pre-Verified-Phone-Number-ID}
  • Auth
    HTTP bearer

Path parameters

Versionstring required

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

Pre-Verified-Phone-Number-IDstring required

The pre-verified phone number ID to delete. This ID is provided by your Business Solution Provider (BSP) during the pre-verification process.

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.

Response

Successfully deleted pre-verified phone number

successboolean

Indicates whether the deletion was successful

Example response

{
  "success": true
}

Changes

No recorded changes to this operation across all 5 revisions of this API.