---
title: SmsMarketingState - Customer API
description: Defines the valid SMS marketing states for a customer’s phone number.
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/customer/latest/enums/SmsMarketingState'
  md: 'https://shopify.dev/docs/api/customer/latest/enums/SmsMarketingState.md'
api_name: customer
api_type: graphql
type: enum
---

# Sms​Marketing​State

enum

Defines the valid SMS marketing states for a customer’s phone number.

## Valid values

* NOT\_​SUBSCRIBED

  The customer has not subscribed to SMS marketing.

* PENDING

  The customer is in the process of subscribing to SMS marketing.

* REDACTED

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

* SUBSCRIBED

  The customer has subscribed to SMS marketing.

* UNSUBSCRIBED

  The customer is not currently subscribed to SMS marketing but was previously subscribed.

***

## Fields

* [Customer​Phone​Number.marketingState](https://shopify.dev/docs/api/customer/latest/objects/CustomerPhoneNumber#field-CustomerPhoneNumber.fields.marketingState)

  OBJECT

  Deprecated

***

## Map