---
schema_version: "1"
id: c8c912359c2b0e931f61d0afc0a79e530f44eca1a100ccd058cef69532c8938e
title: Merge Customer Account (POST)
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/life_sciences_dev_guide/connect_resources_merge_customer_accounts.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/connect_resources_merge_customer_accounts.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 038366f777b893998ee15ad3b8f8342c71b64b306b1b63fb201480260fd5813e
description: Merges a list of customer accounts. If any one account merge in the request fails, the entire operation is cancelled.
---
# Merge Customer Account (POST)

Merges a list of customer accounts. If any one account merge in the request fails, the entire operation is cancelled.

![Important](https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/images/icon_note_important.png)

#### Important

Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations.

## Resource

/connect/life-sciences/commercial/customers/actions/merge

## Resource Example

Replace {yourInstance} with the My Domain name of your Salesforce org.

https://{yourInstance}.salesforce.com/services/data/v68.0/connect/life-sciences/commercial/customers/actions/merge

## Available Version

65.0

## HTTP Methods

POST

## Request Body for POST

{
  "customersToMerge": \[
    {
      "winningId": "001x0000002kl8VFFV",
      "winningExternalId": "001x0000004op0XHHX",
      "losingId": "001x0000009gh6TDDT",
      "losingExternalId": "001x0000001ij7UEEU"
    },
    {
      "winningId": "001x0000003mn9WGGW",
      "winningExternalId": "001x0000007uv3AKKA",
      "losingId": "001x0000006st2ZJJZ",
      "losingExternalId": "001x0000005qr1YIIY"
    }
  \],
  "overrideBlankValues": true
}

<table class="featureTable sort_table" summary="">




          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader vertical-align-top " id="d571204e105">Name</th>

              <th class="featureTableHeader vertical-align-top " id="d571204e108">Type</th>

              <th class="featureTableHeader vertical-align-top " id="d571204e111">Description</th>

              <th class="featureTableHeader vertical-align-top " id="d571204e114">Required</th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d571204e105" data-title="Name"><samp class="codeph nolang">customers​ToMerge</samp></td>

              <td class="entry" headers="d571204e108" data-title="Type"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/connect_requests_merge_customers_input_representation.htm" title="The request to merge a Consolidated Account with a Merged Account.">MergeCustomers​Input​Representation[]</a></td>

              <td class="entry" headers="d571204e111" data-title="Description">A list of customer merge requests. A maximum of 100 requests can be included in a single call.</td>

              <td class="entry" headers="d571204e114" data-title="Required">Required</td>

            </tr>

            <tr>
              <td class="entry" headers="d571204e105" data-title="Name"><samp class="codeph nolang">override​BlankValues</samp></td>

              <td class="entry" headers="d571204e108" data-title="Type">Boolean</td>

              <td class="entry" headers="d571204e111" data-title="Description">Specifies whether to override blank values in the
                Consolidated Account record with values from the Merged
                Account record. The default value is <samp class="codeph nolang">false</samp>. <p class="p">If set to
                  <samp class="codeph nolang">true</samp>, it
                  looks for null values in the fields of the winning
                  account and fills them with non null values from the
                  losing account
                </p>
              </td>

              <td class="entry" headers="d571204e114" data-title="Required">Optional</td>

            </tr>

          </tbody>

        </table>

## Response Body for POST

[Customer Accounts Merged Output](https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/connect_responses_merge_customer_account_output.htm "Output representation of the response for a successful account merge operation.")