Control max price visibility in WhatsApp Manager (BETA)

Updated: Aug 5, 2026

Copy for LLM

A WhatsApp Business Account (WABA) that is enabled for max price also gets the max price template experience in WhatsApp Manager, which includes:

Creating and editing templates with max price settings.

Using the reach and cost estimation card in the template edit flow.

Viewing template max price settings.

Some Solution Partners want to prevent their end-businesses from seeing or configuring template max price settings in WhatsApp Manager, and others want to allow it. To support both models, use the whatsapp_manager_marketing_messages_max_price_enroll_status field on the WhatsApp Business Account to control whether the max price experience appears in WhatsApp Manager for the WABAs you manage:

OPT_IN — the max price experience is shown in WhatsApp Manager for the WABA.

OPT_OUT — the max price experience is hidden in WhatsApp Manager for the WABA.

This setting controls only the visibility of the max price experience in WhatsApp Manager. It doesn’t change a WABA’s eligibility for max price, and it doesn’t affect max price settings configured through the API. Max price is available in Limited Beta — see Enroll in the max price feature.

Before you begin

The WABA must be onboarded to the Marketing Messages API for WhatsApp.

Your app must have an access token with the business_management permission.

Default behavior

The default value depends on whether the WABA is shared with one or more partners.

For a direct integrator, a WABA that your business owns and doesn’t share with a Solution Partner is a non-shared WABA and defaults to OPT_IN.

WABA type	Default value	Max price experience in WhatsApp Manager
Non-shared WABA (0 partners)	`OPT_IN`	Shown
Shared WABA (1 or more partners)	`OPT_OUT`	Hidden

You can override the default at any time by setting the field explicitly.

Who can manage this setting

Read and update access mirrors the Marketing Messages message-sending permission model.

If you are a Solution Partner, you can manage the setting when:

The WABA is shared with 2 or more partners. You must have Messaging or Template Management permission on the WABA.

The WABA is shared with 1 or more partners. The call must come from a valid member or actor of a partner, not from the end-business.

If you own the WABA directly, you can manage the setting only when the WABA is not shared with any partner.

Update the setting

Set the field on the WhatsApp Business Account to show or hide the max price experience in WhatsApp Manager.

Request syntax

curl -X POST 'https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_ACCOUNT_ID>' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "whatsapp_manager_marketing_messages_max_price_enroll_status": "<ENROLL_STATUS>"
}'

Request parameters

Placeholder	Description	Example value
`<ACCESS_TOKEN>` String	Required. System token or business token.	`EAAA...`
`<API_VERSION>` String	Optional. Graph API version.	v26.0
`<WABA_ID>`String	Required. WhatsApp Business Account ID.	`102290129340398`
`<ENROLL_STATUS>` Enum	Required. Whether to show the max price experience in WhatsApp Manager for this WABA. One of `OPT_IN` (shown) or `OPT_OUT` (hidden).	`OPT_OUT`

Example request

curl -X POST 'https://graph.facebook.com/v23.0/102290129340398' \
  -H 'Authorization: Bearer EAAJB...' \
  -H 'Content-Type: application/json' \
  -d '{
  "whatsapp_manager_marketing_messages_max_price_enroll_status": "OPT_OUT"
}'

Example response

{
  "id": "102290129340398"
}

Retrieve the setting

Read the current value of the setting for a WABA.

Request syntax

curl -X GET 'https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_ACCOUNT_ID>?fields=whatsapp_manager_marketing_messages_max_price_enroll_status' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>'

Request parameters

Placeholder	Description	Example value
`<ACCESS_TOKEN>` String	Required. System token or business token.	`EAAA...`
`<API_VERSION>` String	Optional. Graph API version.	v26.0
`<WABA_ID>`String	Required. WhatsApp Business Account ID.	`102290129340398`

Example response

{
  "whatsapp_manager_marketing_messages_max_price_enroll_status": "OPT_OUT",
  "id": "102290129340398"
}

Response fields

Field	Description
`whatsapp_manager_marketing_messages_max_price_enroll_status`	Current setting for the WABA: `OPT_IN` (shown) or `OPT_OUT` (hidden). Always returns a non-null value. If the field was never set explicitly, the default for the WABA type is returned.
`id`	ID of the WhatsApp Business Account.

Error handling

Requests that fail permission or validation checks return standard Graph API errors.

Condition	Behavior
Caller doesn’t have permission to manage the setting	HTTP 403 “You do not have permission to perform this action.” Confirm the caller meets the requirements in Who can manage this setting — an end-business can’t update a shared WABA, and a partner must have Messaging or Template Management permission on the WABA.
Value other than `OPT_IN` or `OPT_OUT` supplied	HTTP 400 with error code 100: “Param `whatsapp_manager_marketing_messages_max_price_enroll_status` must be one of {OPT_IN, OPT_OUT}.” Send exactly `OPT_IN` or `OPT_OUT` — values are case-sensitive.