---
title: >-
  SMS marketing consent now available on the CustomerPhoneNumber object -
  Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/sms-marketing-consent-now-available-on-the-customerphonenumber-object
  md: >-
    https://shopify.dev/changelog/posts/sms-marketing-consent-now-available-on-the-customerphonenumber-object.md
metadata:
  effectiveApiVersion: 2026-10
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
    - displayName: Customer Account API
      handle: customer-account-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: true
  createdAt: '2026-06-18T11:18:26-04:00'
  postedAt: '2026-10-01T12:00:00-04:00'
  updatedAt: '2026-06-18T11:22:07-04:00'
  effectiveAt: '2026-10-01T12:00:00-04:00'
---

October 1, 2026

# SMS marketing consent now available on the CustomerPhoneNumber object

DateOctober 1, 2026

Version[2026-10](https://shopify.dev/changelog?api_version=2026-10)

FlagsNew[Action required](https://shopify.dev/changelog?action_required=true)

SurfacesAPI

Affected APIs[Admin GraphQL API](https://shopify.dev/changelog?api_type=admin-graphql)[Customer Account API](https://shopify.dev/changelog?api_type=customer-account-graphql)

SMS marketing consent is now available through the new `smsMarketingConsent` field on the `CustomerPhoneNumber` object. This field uses the same structured consent model as WhatsApp.

The existing flat SMS marketing consent fields on `CustomerPhoneNumber` remain available for backward compatibility but are now deprecated. New integrations should use `smsMarketingConsent`, and existing integrations should plan to migrate to this field.

For field definitions, data structure, and migration details, see the `CustomerPhoneNumber` object reference in the [API documentation](https://shopify.dev/docs/api/admin-graphql/2026-10/objects/CustomerPhoneNumber).