MergeCustomers1 - Loyalty Admin API

Merges multiple customer accounts into a single account.

After making this call, all customer accounts you specify are merged into a single account.

In case of data conflicts (e.g. different names or birthdays), the priorities match the order of the accounts that you specify, i.e. the data in the first account takes priority over the data in the second account, and the second account takes priority over the third, etc.

An attempt to refer to any of the accounts, including by Bubblehouse ID, will resolve to the merged account.

Kind	Write API call
Method	POST
URL	`https://app.bubblehouse.com/api/v20230601/<shop>/MergeCustomers1`
Authentication	Shop Token

Note that because networking is unreliable, each call needs to have a unique idempotency key, and repeated calls with the same key do nothing and silently succeed. This means that you can safely retry calls failed due to networking errors. To help with testing, use an option that simulates a 500 error.

While customer data is merged during the call, the rest of the processing may complete afterwards, so expect stats and history to keep updating for a little while.

A merge is currently hard (although not impossible) to undo, and you will need Bubblehouse team assistance for that.

Input

customers array of CustomerIdentity1 required

The customer accounts to merge.

You need to specify at least two accounts. All customer accounts will be merged into the first one.
description string optional

An override of the description of the change to show to the customer.
private_note string optional

Extra information about the change for the staff eyes only.

Output

A successful response has no meaningful properties and only contains an ok property always set to true:

{"ok": true}