---
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
---

[Back to Developer changelog](https://shopify.dev/changelog)

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).