---
title: SmsMarketingState - Customer API
description: Defines the valid SMS marketing states for a customer’s phone number.
api_version: 2025-07
api_name: customer
type: enum
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/customer/2025-07/enums/SmsMarketingState'
  md: 'https://shopify.dev/docs/api/customer/2025-07/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.marketingState](https://shopify.dev/docs/api/customer/2025-07/objects/CustomerPhoneNumber#field-CustomerPhoneNumber.fields.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/2025-07/objects/CustomerPhoneNumber#field-CustomerPhoneNumber.fields.marketingState)