---
title: CustomerMarketingConsentState - GraphQL Admin
description: >-
  The valid marketing consent states for a customer on a specific marketing
  channel. The
  [`CustomerMarketingConsent`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/CustomerMarketingConsent)

  interface and channel-specific consent mutations use these values.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/enums/CustomerMarketingConsentState
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/enums/CustomerMarketingConsentState.md
api_name: admin
api_type: graphql
type: enum
---

# Customer​Marketing​Consent​State

enum

The valid marketing consent states for a customer on a specific marketing channel. The [`CustomerMarketingConsent`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/CustomerMarketingConsent) interface and channel-specific consent mutations use these values.

## Valid values

* NEVER\_​SUBSCRIBED

  The customer has never subscribed to marketing on this channel. This is the default state for any channel the customer hasn't interacted with. Read-only: can't be set as an input.

* PENDING

  The customer is in the process of subscribing to marketing on this channel, for example, pending an opt-in confirmation.

* REDACTED

  The customer's personal data is erased. This value is internally-set and read-only.

* SUBSCRIBED

  The customer is subscribed to marketing on this channel.

* UNSUBSCRIBED

  The customer isn't currently subscribed to marketing on this channel but was previously subscribed.

***

## Fields

* [Customer​Marketing​Consent.state](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/CustomerMarketingConsent#fields-state)

  INTERFACE

  The marketing consent information for a [customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) on a specific marketing channel. Channel-specific types like [`CustomerWhatsAppMarketingConsent`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerWhatsAppMarketingConsent) implement this interface.

* [Customer​Marketing​Consent​Input.state](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CustomerMarketingConsentInput#fields-state)

  INPUT OBJECT

  The input fields for marketing consent information when a [customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) consents to receive marketing material on a specific channel. Channel-specific consent mutations like [`customerWhatsAppMarketingConsentUpdate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerWhatsAppMarketingConsentUpdate) use this input.

* [Customer​Sms​Marketing​Consent.state](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerSmsMarketingConsent#field-CustomerSmsMarketingConsent.fields.state)

  OBJECT

  The SMS marketing consent information for a [customer's phone number](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerPhoneNumber). Implements the [`CustomerMarketingConsent`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/CustomerMarketingConsent) interface. Use the [`customerSmsMarketingConsentUpdate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerSmsMarketingConsentUpdate) mutation to change it.

* [Customer​Whats​App​Marketing​Consent.state](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerWhatsAppMarketingConsent#field-CustomerWhatsAppMarketingConsent.fields.state)

  OBJECT

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

***

## Map

### Fields with this enum

* [Customer​Sms​Marketing​Consent.state](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerSmsMarketingConsent#field-CustomerSmsMarketingConsent.fields.state)
* [Customer​Whats​App​Marketing​Consent.state](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerWhatsAppMarketingConsent#field-CustomerWhatsAppMarketingConsent.fields.state)

### Inputs with this enum

* [Customer​Marketing​Consent​Input.state](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CustomerMarketingConsentInput#fields-state)