Merges source contacts into a target contact.
Merging contacts has these effects on the target contact:
Source contacts are deleted when merging.
However, if a source contact is a site member or collaborator,
the mergeContacts()
function fails because site collaborators and members can't be deleted.
Site members and collaborators can only be target contacts.
After merging, if you call the getContact()
function with a deleted source contact ID, the target contact ID is returned. This is only supported when calling getContact()
. Previously deleted source contact IDs can't be passed in any other function.
This function requires elevated permissions and runs only on the backend and on dashboard pages.
Target contact ID.
Target contact revision number, which increments by 1 each time the contact is updated. To prevent conflicting changes, the target contact's current revision must be passed.
Merge contacts options.