mergeContacts( )

Merges source contacts into a target contact.

Merging contacts has the following effects on the target contact:

• No target contact data is overwritten or deleted.
• Arrays (emails, phone numbers, addresses, and labels) from the source contacts are added to the target contact's arrays.
• If you merge more than one source contact, the 1st source contact specified is added first, then the 2nd, and so on.
• If there is duplicate information between the target contact and the source contact, the information isn't dupilcated in the target contact's arrays.

When you merge contacts, source contacts are typically deleted. However, if a source contact is a site member or a Wix user, the merge will fail because site members and Wix users can't be deleted. This means that site members and Wix users can only be specified as target contacts in a merge.

After merging, calling Get Contact with a deleted source contact ID returns the target contact ID. Specifying a deleted source contact ID is not supported on any other method.

When contacts are merged:

• The Contact Merged event is triggered.
• The Contact Updated event is triggered for the target contact. originatedFrom is set to merge.
• The Contact Deleted event is triggered for each source contact. originatedFrom is set to merge.