Skip to main content

WhatsApp Cloud API - Commerce Settings API | Developer Documentation

WhatsApp Cloud API - Commerce Settings API

Copy for LLM
Version
Configure WhatsApp Business commerce settings including catalog visibility
and shopping cart enablement. Retrieve and update commerce configurations
for business phone numbers.

Base URL

https://graph.facebook.com

Endpoints


GET /{Version}/{Phone-Number-ID}/whatsapp_commerce_settings

Request Syntax

GET /{Version}/{Phone-Number-ID}/whatsapp_commerce_settings
Try it
Select language

curl--requestGET \
--url'https://graph.facebook.com/{Version}/{Phone-Number-ID}/whatsapp_commerce_settings' \
--header'Authorization: Bearer <Token>' \
--header'Content-Type: application/json' \
--data'{}'
Select status code

{
"Example response": {
"value": {
"data": [
        {
"id""527759822865714",
"is_cart_enabled"true,
"is_catalog_visible"true
        }
      ]
    }
  }
}
Header Parameters
User-Agentstring
The user agent string identifying the client software making the request.
Authorizationstring·required
Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.
Path Parameters
Versionstring·required
Phone-Number-IDstring·required
Responses
200
Example response
Content Type: application/json
Schema: object
Show child attributes

dataarray of object
Show child attributes

data[]object
Show child attributes

idstring

is_cart_enabledboolean

is_catalog_visibleboolean
Select language

curl--requestGET \
--url'https://graph.facebook.com/{Version}/{Phone-Number-ID}/whatsapp_commerce_settings' \
--header'Authorization: Bearer <Token>' \
--header'Content-Type: application/json' \
--data'{}'
Select status code

{
"Example response": {
"value": {
"data": [
        {
"id""527759822865714",
"is_cart_enabled"true,
"is_catalog_visible"true
        }
      ]
    }
  }
}

POST /{Version}/{Phone-Number-ID}/whatsapp_commerce_settings

Request Syntax

POST /{Version}/{Phone-Number-ID}/whatsapp_commerce_settings
Try it
Select language

curl--request POST \
--url'https://graph.facebook.com/{Version}/{Phone-Number-ID}/whatsapp_commerce_settings' \
--header'Authorization: Bearer <Token>' \
--header'Content-Type: application/json' \
--data'{}'
Select status code

{
"Example response": {
"value": {
"success"true
    }
  }
}
Header Parameters
User-Agentstring
The user agent string identifying the client software making the request.
Authorizationstring·required
Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.
Path Parameters
Versionstring·required
Phone-Number-IDstring·required
Query Parameters
is_cart_enabledstring
is_catalog_visiblestring
Responses
200
Example response
Content Type: application/json
Schema: object
Show child attributes

successboolean
Select language

curl--request POST \
--url'https://graph.facebook.com/{Version}/{Phone-Number-ID}/whatsapp_commerce_settings' \
--header'Authorization: Bearer <Token>' \
--header'Content-Type: application/json' \
--data'{}'
Select status code

{
"Example response": {
"value": {
"success"true
    }
  }
}

Authentication

Scheme
Type
Location
bearerAuth
HTTP Bearer
Header: Authorization

Usage Examples

bearerAuth:
Include Authorization: Bearer your-token-here in request headers

Global Authentication Requirements

All endpoints require:
bearerAuth