MEmeta
Settings

Update phone number settings

Update various settings for a WhatsApp Business phone number. You can configure calling settings, user identity change settings, payload encryption, and data storage configurations. Only one feature setting can be specified per request.

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

Request

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

Path parameters

Versionstring required
Example:v22.0
Phone-Number-IDstring required
Example:123456789012345

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.

Content-Type'application/json' | 'application/x-www-form-urlencoded' | 'multipart/form-data' required
Example:application/json

Media type of the request body

Request body

OR
OR
OR

Example request

{
  "calling": {
    "status": "enabled",
    "call_icon_visibility": "visible"
  }
}

Response

Settings updated successfully

successboolean

Example response

{
  "success": true
}

Changes

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