Merge Customer Account (POST)

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

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.

Important

Resource
1/connect/life-sciences/commercial/customers/actions/merge
Resource Example
1https://yourInstance.salesforce.com/services/data/v67.0/connect/life-sciences/commercial/customers/actions/merge
Available version
65.0
HTTP methods
POST
Request body for POST
1{
2  "customersToMerge": [
3    {
4      "winningId": "001x0000002kl8VFFV",
5      "winningExternalId": "001x0000004op0XHHX",
6      "losingId": "001x0000009gh6TDDT",
7      "losingExternalId": "001x0000001ij7UEEU"
8    },
9    {
10      "winningId": "001x0000003mn9WGGW",
11      "winningExternalId": "001x0000007uv3AKKA",
12      "losingId": "001x0000006st2ZJJZ",
13      "losingExternalId": "001x0000005qr1YIIY"
14    }
15  ],
16  "overrideBlankValues": true
17}
Name Type Description Required
customers​ToMerge MergeCustomers​Input​Representation[] A list of customer merge requests. A maximum of 100 requests can be included in a single call. Required
override​BlankValues Boolean Specifies whether to override blank values in the Consolidated Account record with values from the Merged Account record. The default value is false.

If set to true, it looks for null values in the fields of the winning account and fills them with non null values from the losing account

Optional
Response body for POST
Customer Accounts Merged Output