---
title: CustomerPhoneNumber - Customer API
description: Defines the phone number of the customer. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data).
api_version: 2025-10
api_name: customer
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/customer/latest/objects/customerphonenumber
  md: https://shopify.dev/docs/api/customer/latest/objects/customerphonenumber.md
---

# Customer​Phone​Number

object

Defines the phone number of the customer. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data).

## Fields

* marketing​State

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

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  Indicates whether the customer has subscribed to SMS marketing material.

* phone​Number

  [String!](https://shopify.dev/docs/api/customer/latest/scalars/String)

  non-null

  The customer's phone number.

***

## Map

### Fields with this object

* {}[Customer.phoneNumber](https://shopify.dev/docs/api/customer/latest/objects/Customer#field-phoneNumber)