---
title: CustomerEmailAddress - GraphQL Admin
description: Represents an email address.
api_version: 2025-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/2025-01/objects/customeremailaddress
  md: https://shopify.dev/docs/api/admin-graphql/2025-01/objects/customeremailaddress.md
---

# Customer​Email​Address

object

Requires `read_customers` access scope.

Represents an email address.

## Fields

* email​Address

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

  non-null

  The customer's default email address.

* marketing​State

  [Customer​Email​Address​Marketing​State!](https://shopify.dev/docs/api/admin-graphql/2025-01/enums/CustomerEmailAddressMarketingState)

  non-null

  Whether the customer has subscribed to email marketing.

* marketing​Unsubscribe​Url

  [URL!](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/URL)

  non-null

  The URL to unsubscribe a member from all mailing lists.

* open​Tracking​Level

  [Customer​Email​Address​Open​Tracking​Level!](https://shopify.dev/docs/api/admin-graphql/2025-01/enums/CustomerEmailAddressOpenTrackingLevel)

  non-null

  Whether the customer has opted in to having their opened emails tracked.

* open​Tracking​Url

  [URL!](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/URL)

  non-null

  The URL that can be used to opt a customer in or out of email open tracking.

***

## Map

### Fields with this object

* {}[CustomerMergePreviewAlternateFields.email](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/CustomerMergePreviewAlternateFields#field-CustomerMergePreviewAlternateFields.fields.email)
* {}[CustomerMergePreviewDefaultFields.email](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/CustomerMergePreviewDefaultFields#field-CustomerMergePreviewDefaultFields.fields.email)
* {}[CustomerSegmentMember.defaultEmailAddress](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/CustomerSegmentMember#field-CustomerSegmentMember.fields.defaultEmailAddress)