---
title: CustomerWhatsAppMarketingConsent - Customer API
description: >-
  The WhatsApp marketing consent information for a

  [customer phone
  number](https://shopify.dev/docs/api/customer/latest/objects/CustomerPhoneNumber).

  Implements the
  [`CustomerMarketingConsent`](https://shopify.dev/docs/api/customer/latest/interfaces/CustomerMarketingConsent)
  interface.

  Use the
  [`customerWhatsAppMarketingConsentUpdate`](https://shopify.dev/docs/api/customer/latest/mutations/customerWhatsAppMarketingConsentUpdate)
  mutation to update it.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/customer/latest/objects/CustomerWhatsAppMarketingConsent
  md: >-
    https://shopify.dev/docs/api/customer/latest/objects/CustomerWhatsAppMarketingConsent.md
api_name: customer
api_type: graphql
type: object
---

# Customer​Whats​App​Marketing​Consent

object

Requires `customer_read_customers` access scope.

The WhatsApp marketing consent information for a [customer phone number](https://shopify.dev/docs/api/customer/latest/objects/CustomerPhoneNumber). Implements the [`CustomerMarketingConsent`](https://shopify.dev/docs/api/customer/latest/interfaces/CustomerMarketingConsent) interface. Use the [`customerWhatsAppMarketingConsentUpdate`](https://shopify.dev/docs/api/customer/latest/mutations/customerWhatsAppMarketingConsentUpdate) mutation to update it.

## Fields

* state

  [Marketing​Consent​State!](https://shopify.dev/docs/api/customer/latest/enums/MarketingConsentState)

  non-null

  The customer's current [marketing consent state](https://shopify.dev/docs/api/customer/latest/enums/MarketingConsentState) for this channel.

***

## Map

### Fields with this object

* [CustomerPhoneNumber.whatsAppMarketingConsent](https://shopify.dev/docs/api/customer/latest/objects/CustomerPhoneNumber#field-CustomerPhoneNumber.fields.whatsAppMarketingConsent)

***

## Interfaces

* [Customer​Marketing​Consent](https://shopify.dev/docs/api/customer/latest/interfaces/CustomerMarketingConsent)

  interface

***

## CustomerWhatsAppMarketingConsent Implements

### Implements

* [Customer​Marketing​Consent](https://shopify.dev/docs/api/customer/latest/interfaces/CustomerMarketingConsent)