---
title: Introducing the new Customer Merge API - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: 'https://shopify.dev/changelog/introducing-the-new-customer-merge-api'
  md: 'https://shopify.dev/changelog/introducing-the-new-customer-merge-api.md'
metadata:
  effectiveApiVersion: 2023-04
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2023-02-21T14:29:28-05:00'
  postedAt: '2023-04-01T00:00:00-04:00'
  updatedAt: '2024-12-13T17:24:36-05:00'
  effectiveAt: '2023-04-01T00:00:00-04:00'
---

April 1, 2023

Tags:

* API
* 2023-04

# Introducing the new Customer Merge API

As of GraphQL Admin API version **2023-04**, you can now use the Customer Merge API to combine two separate customer profiles with certain non-blocking criteria. You can use the new mutations and queries to:

* [Preview a customer merge](https://shopify.dev/api/admin-graphql/2023-04/queries/customerMergePreview)
* [Merge two customers](https://shopify.dev/api/admin-graphql/2023-04/mutations/customerMerge)
* [Follow the status of an ongoing merge](https://shopify.dev/api/admin-graphql/2023-04/queries/customerMergeJobStatus)

Additionally, you can check whether a customer can be merged with another customer using the new [Customer.mergeable](https://shopify.dev/api/admin-graphql/2023-04/objects/Customer#field-customer-mergeable) field. This field is also available on the CustomerSegmentMember API [CustomerSegmentMember. mergeable](https://shopify.dev/docs/api/admin-graphql/2023-04/objects/CustomerSegmentMember#field-customersegmentmember-mergeable).

You can learn more about merging customer profiles on [Shopify Help Center](https://help.shopify.com/en/manual/customers/manage-customers#merging-customer-profiles).