---
title: CustomerPhoneNumber - GraphQL Admin
description: A phone number.
api_version: 2024-10
api_name: admin
type: object
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/objects/CustomerPhoneNumber
  md: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/objects/CustomerPhoneNumber.txt
---

# Customer​Phone​Number

object

Requires `read_customers` access scope.

A phone number.

## Fields

* marketing​State

  [Customer​Sms​Marketing​State!](https://shopify.dev/docs/api/admin-graphql/2024-10/enums/CustomerSmsMarketingState)

  non-null

  Whether the customer has subscribed to SMS marketing material.

* phone​Number

  [String!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/String)

  non-null

  A customer's phone number.

***

## Map

### Fields with this object

* {}[CustomerMergePreviewAlternateFields.phoneNumber](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/CustomerMergePreviewAlternateFields#field-phoneNumber)
* {}[CustomerMergePreviewDefaultFields.phoneNumber](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/CustomerMergePreviewDefaultFields#field-phoneNumber)
* {}[CustomerSegmentMember.defaultPhoneNumber](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/CustomerSegmentMember#field-defaultPhoneNumber)