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

# 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.​marketing​State](https://shopify.dev/docs/api/customer/latest/objects/CustomerPhoneNumber#field-marketingState)

  OBJECT

  Defines the phone number of the customer. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data).

***

## Map

### Fields with this enum

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