---
title: customerWhatsAppMarketingConsentUpdate - GraphQL Admin
description: >-
  Updates a
  [customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer)'s
  WhatsApp marketing consent information. Shopify identifies the customer's

  WhatsApp account by their [phone
  number](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerPhoneNumber).


  You can subscribe or unsubscribe the customer from WhatsApp marketing and

  specify the [opt-in
  level](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerWhatsAppMarketingConsentUpdate#arguments-input.fields.whatsAppMarketingConsent.optInLevel).

  You can also include when and
  [where](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerWhatsAppMarketingConsentUpdate#arguments-input.fields.whatsAppMarketingConsent.sourceLocationId)

  the consent was collected.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerWhatsAppMarketingConsentUpdate
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerWhatsAppMarketingConsentUpdate.md
api_name: admin
api_type: graphql
type: mutation
---

# customer​Whats​App​Marketing​Consent​Update

mutation

Requires `write_customers` access scope. Also: The user must have permission to create and edit customers.

Updates a [customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer)'s WhatsApp marketing consent information. Shopify identifies the customer's WhatsApp account by their [phone number](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerPhoneNumber).

You can subscribe or unsubscribe the customer from WhatsApp marketing and specify the [opt-in level](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerWhatsAppMarketingConsentUpdate#arguments-input.fields.whatsAppMarketingConsent.optInLevel). You can also include when and [where](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerWhatsAppMarketingConsentUpdate#arguments-input.fields.whatsAppMarketingConsent.sourceLocationId) the consent was collected.

## Arguments

* input

  [Customer​Whats​App​Marketing​Consent​Update​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CustomerWhatsAppMarketingConsentUpdateInput)

  required

  Specifies the input fields to update a customer's WhatsApp marketing consent information.

***

## Customer​Whats​App​Marketing​Consent​Update​Payload returns

* customer​Phone​Number

  [Customer​Phone​Number](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerPhoneNumber)

  The [customer phone number](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerPhoneNumber) with the updated WhatsApp marketing consent information.

* user​Errors

  [\[Customer​Marketing​Consent​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerMarketingConsentError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### customerWhatsAppMarketingConsentUpdate reference