---
title: MarketingConsentState - Customer API
description: >-
  The valid marketing consent states for a customer on a specific marketing
  channel. The

  [`CustomerMarketingConsent`](https://shopify.dev/docs/api/customer/latest/interfaces/CustomerMarketingConsent)
  interface and channel-specific consent mutations use these values.
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/customer/latest/enums/MarketingConsentState'
  md: 'https://shopify.dev/docs/api/customer/latest/enums/MarketingConsentState.md'
api_name: customer
api_type: graphql
type: enum
---

# Marketing​Consent​State

enum

The valid marketing consent states for a customer on a specific marketing channel. The [`CustomerMarketingConsent`](https://shopify.dev/docs/api/customer/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/customer/latest/interfaces/CustomerMarketingConsent#fields-state)

  INTERFACE

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

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

  INPUT OBJECT

  The input fields for setting marketing consent on a customer's marketing channel. Channel-specific consent mutations like [`customerWhatsAppMarketingConsentUpdate`](https://shopify.dev/docs/api/customer/latest/mutations/customerWhatsAppMarketingConsentUpdate) use this input.

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

  OBJECT

  The SMS 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.

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

  OBJECT

  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.

***

## Map

### Fields with this enum

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

### Inputs with this enum

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