---
title: Customer - Customer API
description: >-
  Represents the personal information of a 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: 2026-01
api_name: customer
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/customer/latest/objects/Customer'
  md: 'https://shopify.dev/docs/api/customer/latest/objects/Customer.md'
---

# Customer

object

Represents the personal information of a customer. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data).

## Fields

* addresses
* companyContacts
* creationDate
* defaultAddress
* displayName
* draftOrders
* emailAddress
* firstName
* id
* imageUrl
* lastIncompleteCheckout
* lastName
* metafield
* metafields
* orders
* phoneNumber
* storeCreditAccounts
* subscriptionContract
* subscriptionContracts
* tags

***

## Map

### Fields with this object

* [CompanyContact.customer](https://shopify.dev/docs/api/customer/latest/objects/CompanyContact#field-CompanyContact.fields.customer)
* [DraftOrder.customer](https://shopify.dev/docs/api/customer/latest/objects/DraftOrder#field-DraftOrder.fields.customer)
* [Order.customer](https://shopify.dev/docs/api/customer/latest/objects/Order#field-Order.fields.customer)

### Possible type in

* [Purchasing​Entity](https://shopify.dev/docs/api/customer/latest/unions/PurchasingEntity)

***

## Queries

* customer

***

## Customer Queries

### Queried by

* [customer](https://shopify.dev/docs/api/customer/latest/queries/customer)

***

## Mutations

* customerUpdate

***

## Customer Mutations

### Mutated by

* [customer​Update](https://shopify.dev/docs/api/customer/latest/mutations/customerUpdate)

***

## Interfaces

* HasMetafields
* HasStoreCreditAccounts
* Node

***

## Customer Implements

### Implements

* [Has​Metafields](https://shopify.dev/docs/api/customer/latest/interfaces/HasMetafields)
* [Has​Store​Credit​Accounts](https://shopify.dev/docs/api/customer/latest/interfaces/HasStoreCreditAccounts)
* [Node](https://shopify.dev/docs/api/customer/latest/interfaces/Node)