---
title: CustomerSmsMarketingConsent - Customer API
description: >-
  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.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/customer/latest/objects/CustomerSmsMarketingConsent
  md: >-
    https://shopify.dev/docs/api/customer/latest/objects/CustomerSmsMarketingConsent.md
api_name: customer
api_type: graphql
type: object
---

# Customer​Sms​Marketing​Consent

object

Requires `customer_read_customers` access scope.

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.

## Fields

* state

  [Marketing​Consent​State!](https://shopify.dev/docs/api/customer/latest/enums/MarketingConsentState)

  non-null

  The customer's current [marketing consent state](https://shopify.dev/docs/api/customer/latest/enums/MarketingConsentState) for this channel.

***

## Map

### Fields with this object

* [CustomerPhoneNumber.smsMarketingConsent](https://shopify.dev/docs/api/customer/latest/objects/CustomerPhoneNumber#field-CustomerPhoneNumber.fields.smsMarketingConsent)

***

## Interfaces

* [Customer​Marketing​Consent](https://shopify.dev/docs/api/customer/latest/interfaces/CustomerMarketingConsent)

  interface

***

## CustomerSmsMarketingConsent Implements

### Implements

* [Customer​Marketing​Consent](https://shopify.dev/docs/api/customer/latest/interfaces/CustomerMarketingConsent)