---
title: CustomerMergeError - GraphQL Admin
description: The error blocking a customer merge.
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/CustomerMergeError
  md: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/objects/CustomerMergeError.txt
---

# Customer​Merge​Error

object

Requires The user must have `read_customer_merge` permissions.

The error blocking a customer merge.

## Fields

* error​Fields

  [\[Customer​Merge​Error​Field​Type!\]!](https://shopify.dev/docs/api/admin-graphql/2024-10/enums/CustomerMergeErrorFieldType)

  non-null

  The list of fields preventing the customer from being merged.

* message

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

  non-null

  The customer merge error message.

***

## Map

### Fields with this object

* {}[CustomerMergePreview.customerMergeErrors](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/CustomerMergePreview#field-customerMergeErrors)
* {}[CustomerMergeRequest.customerMergeErrors](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/CustomerMergeRequest#field-customerMergeErrors)