---
title: "Update phone number settings"
method: POST
path: "/{Version}/{Phone-Number-ID}/settings"
tags: ["Settings"]
---

# Update phone number settings

`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

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.

## Path parameters

- `Version` string, required
- `Phone-Number-ID` string, required

## Headers

- `User-Agent` string
- `Authorization` string, required
- `Content-Type` 'application/json' | 'application/x-www-form-urlencoded' | 'multipart/form-data', required

## Request body

- union
  - object
    - `calling` CallingSettings, required
      - `status` 'enabled' | 'disabled', required: Enable or disable calling feature
      - `call_icon_visibility` 'visible' | 'hidden': Control visibility of the call icon
  - object
    - `user_identity_change` UserIdentityChangeSettings, required
      - `enabled` boolean, required: Enable or disable user identity change notifications
  - object
    - `payload_encryption` PayloadEncryptionSettings, required
      - `status` 'enabled' | 'disabled', required: Enable or disable payload encryption
      - `client_encryption_key` string: Base64-encoded public key for payload encryption (required when enabling encryption)
  - object
    - `storage_configuration` StorageConfigurationSettings, required
      - `enabled` boolean, required: Enable or disable custom storage configuration
      - `region` string: Data storage region

## Response `200`

Settings updated successfully

- object
  - `success` boolean

## Other responses

- `400`: Bad Request - Invalid request parameters
- `403`: Forbidden - Template not approved or insufficient permissions

---

[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)