Phone Number Management

Deregister WhatsApp Business Phone Number

Deregister a WhatsApp Business phone number from the Facebook Hosted System. This operation removes the phone number from the WhatsApp Business Platform and makes it available for re-registration if needed.

Important Notes:

  • Phone number must be currently linked in Facebook Hosted System
  • Phone number must be registered on the WhatsApp Business Platform
  • Cannot deregister phone numbers associated with SMB accounts
  • Rate limiting is enforced to prevent abuse
  • Deregistration triggers activity logging for audit purposes

Rate Limiting: Standard Graph API rate limits apply with additional restrictions for registration operations. Use appropriate retry logic with exponential backoff.

Caching: Deregistration status changes are immediate and should not be cached.

post/{Version}/{Phone-Number-ID}/deregister

Request

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

Path parameters

Versionstring required

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

Phone-Number-IDstring required

The ID of the phone number to deregister. This ID is provided when you register the phone number and can be found in your WhatsApp Business Account settings.

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 deregistered the phone number

successboolean required

Indicates whether the deregistration was successful

Example response

{
  "success": true
}

Changes

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