---
title: CustomerEmailAddress - Customer API
description: >-
  An email address associated with 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/CustomerEmailAddress'
  md: 'https://shopify.dev/docs/api/customer/latest/objects/CustomerEmailAddress.md'
---

# Customer​Email​Address

object

An email address associated with 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

* email​Address

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

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

  The email address of the customer.

* marketing​State

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

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

  The customer's subscription status for email marketing.

***

## Map

### Fields with this object

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

***

## Mutations

* [customer​Email​Marketing​Subscribe](https://shopify.dev/docs/api/customer/latest/mutations/customerEmailMarketingSubscribe)

  mutation

  Subscribes the customer to email marketing.

* [customer​Email​Marketing​Unsubscribe](https://shopify.dev/docs/api/customer/latest/mutations/customerEmailMarketingUnsubscribe)

  mutation

  Unsubscribes the customer from email marketing.

***

## CustomerEmailAddress Mutations

### Mutated by

* [customer​Email​Marketing​Subscribe](https://shopify.dev/docs/api/customer/latest/mutations/customerEmailMarketingSubscribe)
* [customer​Email​Marketing​Unsubscribe](https://shopify.dev/docs/api/customer/latest/mutations/customerEmailMarketingUnsubscribe)