Create customer merge

post https://api.kustomerapp.com/v1/customers/merges

Creates a customer merge based on a set of source customer and target customer IDs.

Any one of the following roles is required for this endpoint:

Legacy Role	Equivalent Permission Set Role
org.user.customer.write	org.permission.customer_merge.create
org.admin.customer.merge.write

Merge rules

Customer merges follow these rules:

Merge the following fields:

Emails
Phones
Socials
Locations
Watchers
Custom (target customer ID takes precedence with same attribute names)
Tags
KlassNames
conversationCounts (sums all values)

Choose based on most recent value:

Preview - Based on preview.previewAt
LastMessageIn - Based on lastMessageIn.sentAt
lastConversation - Based on lastMessageIn.sentAt
recentLocation - Based on recentLocation.updatedAt
signedUpAt
modifiedAt / modifiedBy
lastSeenAt
lastActivityAt

Choose based on the oldest value:

createdAt / createdBy

Give precedence to the target customer ID value:

Company
name
externalId
username
avatarUrl
locale
timeZone
birthdayAt
gender

Response

Language

Credentials

Bearer


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api.kustomerapp.com/v1/customers/merges \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Created