← All Shopify Updates

Shopify Adds defaultPhoneNumber Field to Customer Object in 2025

What Changed

Shopify has introduced a new defaultPhoneNumber field to the Customer object in GraphQL Admin API version 2025-04. This field enables developers to query a customer's phone number directly along with their associated marketing state. The addition provides a more streamlined way to access customer contact information through the Admin API.

Why This Matters

For Shopify developers building customer management tools, marketing automations, and communication platforms, having direct access to the default phone number field simplifies API queries and reduces the need for workarounds. This enhancement improves data accessibility and supports better customer engagement strategies, particularly for SMS marketing and notification workflows.

What You Should Do

• Update your GraphQL queries to use API version 2025-04 or later to access the new defaultPhoneNumber field
• Review your existing customer data queries to determine if consolidating phone number retrieval would benefit your app's performance
• Consult the official Shopify changelog and Customer fields documentation for complete field specifications and usage examples

How GetShopifyToken Helps

GetShopifyToken streamlines the authentication process for accessing Shopify's GraphQL Admin API. With secure OAuth token management, you can quickly set up the necessary credentials to query the new defaultPhoneNumber field and other customer data without managing authentication complexity yourself.

← More Shopify Updates