Merge Contacts

POST {{baseUrl}}/api/v1/contacts/:contact_id/merge

This API merges two or more contacts

Note:
Though portal users (users who signed up via the help center) are saved as contacts in the help desk, their records cannot be merged with other records/contacts.

OAuth Scope

  • Desk.contacts.UPDATE

Attributes

Attribute NameData TypeDescription
ids (required)<list>
Array containing the IDs of the contacts to merge
source<object>
JSON object containing details of the contact

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring

RESPONSES

status: OK

{&quot;lastName&quot;:&quot;Lawrence&quot;,&quot;modifiedTime&quot;:&quot;2016-05-04T09:57:17.000Z&quot;,&quot;country&quot;:null,&quot;secondaryEmail&quot;:null,&quot;city&quot;:null,&quot;description&quot;:null,&quot;ownerId&quot;:&quot;1892000000042001&quot;,&quot;type&quot;:null,&quot;title&quot;:null,&quot;photoURL&quot;:&quot;https://desk.zoho.com/api/v1/contacts/1892000000042032/photo&quot;,&quot;twitter&quot;:null,&quot;isDeleted&quot;:false,&quot;street&quot;:null,&quot;createdTime&quot;:&quot;2013-11-04T11:21:07.000Z&quot;,&quot;zohoCRMContact&quot;:{&quot;id&quot;:&quot;5000000014010&quot;,&quot;type&quot;:&quot;contacts_leads&quot;},&quot;customerHappiness&quot;:{&quot;badPercentage&quot;:&quot;22&quot;,&quot;okPercentage&quot;:&quot;31&quot;,&quot;goodPercentage&quot;:&quot;47&quot;},&quot;state&quot;:null,&quot;id&quot;:&quot;1892000000042032&quot;,&quot;email&quot;:&quot;lawrence@zylker.com&quot;,&quot;zip&quot;:null,&quot;cf&quot;:{&quot;cf_permanentaddress&quot;:null,&quot;cf_lastcontactedon&quot;:null},&quot;isFollowing&quot;:&quot;true&quot;,&quot;facebook&quot;:null,&quot;mobile&quot;:null,&quot;accountId&quot;:&quot;1892000000975382&quot;,&quot;firstName&quot;:&quot;Jennifer&quot;,&quot;isAnonymous&quot;:false,&quot;phone&quot;:&quot;1 888 900 9646&quot;,&quot;isSpam&quot;:false}