---
title: CustomerSmsMarketingState - GraphQL Admin
description: The valid SMS marketing states for a customer’s phone number.
api_version: 2024-10
api_name: admin
type: enum
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/enums/CustomerSmsMarketingState
  md: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/enums/CustomerSmsMarketingState.txt
---

# Customer​Sms​Marketing​State

enum

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

## Valid values

* NOT\_​SUBSCRIBED

  The customer hasn't subscribed to SMS marketing.

* PENDING

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

* REDACTED

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

* SUBSCRIBED

  The customer is subscribed to SMS marketing.

* UNSUBSCRIBED

  The customer isn't currently subscribed to SMS marketing but was previously subscribed.

***

## Fields

* [Customer​Phone​Number.​marketing​State](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/CustomerPhoneNumber#field-marketingState)

  OBJECT

  A phone number.

* [Customer​Sms​Marketing​Consent​Input.​marketing​State](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/CustomerSmsMarketingConsentInput#field-marketingState)

  INPUT OBJECT

  The marketing consent information when the customer consented to receiving marketing material by SMS.

* [Customer​Sms​Marketing​Consent​State.​marketing​State](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/CustomerSmsMarketingConsentState#field-marketingState)

  OBJECT

  The record of when a customer consented to receive marketing material by SMS.

  The customer's consent state reflects the record with the most recent date when consent was updated.

***

## Map

### Fields with this enum

* <-|[Customer​Phone​Number.marketingState](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/CustomerPhoneNumber#field-marketingState)
* <-|[Customer​Sms​Marketing​Consent​State.marketingState](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/CustomerSmsMarketingConsentState#field-marketingState)

### Inputs with this enum

* [Customer​Sms​Marketing​Consent​Input.marketingState](https://shopify.dev/docs/api/admin-graphql/2024-10/input-objects/CustomerSmsMarketingConsentInput#field-marketingState)