detektu
Shopify API changes
Info

SMS marketing consent now available on the CustomerPhoneNumber object

doc:019fb619-9b4a-74ac-a83e-3ffa98844fb4::feed/https://shopify.dev/changelog/sms-marketing-consent-now-available-on-the-customerphonenumber-object
Product
Shopify Admin GraphQL API
Source
Feed
Change kind
Feed Entry
Detected
Last updated

Deterministic evidence

Before / after

Extracted from Shopify's published contract. Open the source ↗

−1+81 change

1 / 1
null
{
"content_hash": "5e4821a7499d2f953fb1802342c3413b8bd2b023fd8296bfbad965ac84e9964c",
"excerpt": "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…",
"identity": "https://shopify.dev/changelog/sms-marketing-consent-now-available-on-the-customerphonenumber-object",
"link": "https://shopify.dev/changelog/sms-marketing-consent-now-available-on-the-customerphonenumber-object",
"published_at": "2026-10-01T16:00:00Z",
"title": "SMS marketing consent now available on the CustomerPhoneNumber object"
}

Interpreted documentation change

What the vendor announced

The evidence reports a change where SMS marketing consent is introduced as a new field smsMarketingConsent on the CustomerPhoneNumber object, with backward-compatibility existing fields deprecated and migration guidance provided. It is categorized as informational since it conveys a documentation changelog note rather than a policy change, rate limit, or deprecation of an endpoint. A specific deadline or replacement endpoint is not explicitly stated in the text.

SMS marketing consent now available on the CustomerPhoneNumber object 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…

Vendor source ↗

Monitored for you

Does this change affect your integration?

Choose the operations and fields your services use. Detektu matches Shopify findings to that declared usage so your team can review the relevant evidence. No agent or repository access required.

Monitor Shopify free See pricing

Multi-source correlation

Other Shopify findings correlated with this change across sources.

  1. Deprecation
    SDK version 12.3.0 yankedsdk:npm/@shopify/shopify-api@12.3.0
    Shopify Admin GraphQL API