List details of duplicate contacts
GET {{baseUrl}}/api/v1/groupContacts?fieldName=<string> max chars : 100&fieldValues=<string> max chars : 100
This API lists all the details of duplicate contacts.The fieldName and fieldValues parameters are mandatory in the API request
OAuth Scope
Desk.contacts.READ
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
fieldName | string | Name of the field whose values must be matched for deduplication. Values allowed are: <br>firstName,<br> <br>lastName,<br> <br>email,<br> <br>secondaryEmail,<br> <br>phone,<br> <br>fullName,<br> and <br>bothEmail.<br> | |
sortBy | string | Key that sorts the contacts by a specific attribute: <br>firstName,<br> <br>lastName,<br> <br>fullName,<br> <br>phone,<br> <br>email,<br> <br>account,<br> <br>createdTime,<br> <br>modifiedTime<br> | |
from | string | Index number starting from which the contacts must be fetched | |
limit | string | Number of contacts to fetch | |
fieldValues | string | Actual values in each field related to the contact | |
include | string | Secondary information related to the contact. Value allowed is: accounts |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Authorization | string |
RESPONSES
status: OK
{"data":[{"fieldValue":"Jade","contacts":[{"lastName":"Jade","secondaryEmail":null,"ownerId":null,"type":null,"accountId":"1892000000091433","firstName":"Jonathan","photoURL":"https://desk.zoho.com/api/v1/contacts/1892000000772003/photo","phone":"555555","webUrl":"https://desk.zoho.com/support/zylker/ShowHomePage.do#Contacts/dv/d126330fb061247d9ebddaeb9d93ba74750b0284bc703b38","createdTime":"2017-10-12T13:11:50.000Z","zohoCRMContact":null,"id":"1892000000772003","isSpam":false,"customerHappiness":{"badPercentage":"0","okPercentage":"0","goodPercentage":"0"},"email":"case@zylker.com"},{"lastName":"Jade","secondaryEmail":null,"ownerId":null,"type":null,"accountId":"1892000000052077","firstName":"Christ","photoURL":null,"phone":null,"webUrl":"https://desk.zoho.com/support/zylker/ShowHomePage.do#Contacts/dv/d126330fb061247d9ebddaeb9d93ba74750b0284bc703b38","createdTime":"2017-10-12T13:11:50.000Z","zohoCRMContact":{"id":"1892000000772030","type":"contacts_leads"},"id":"1892000000772001","isSpam":false,"customerHappiness":{"badPercentage":"22","okPercentage":"31","goodPercentage":"47"},"email":"jade@zylker.com"}]},{"fieldValue":"Christ","contacts":[{"lastName":"Jade","secondaryEmail":null,"ownerId":null,"type":null,"accountId":"1892000000091433","firstName":"Christ","photoURL":"https://desk.zoho.com/api/v1/contacts/1892000000772003/photo","phone":"555555","webUrl":"https://desk.zoho.com/support/zylker/ShowHomePage.do#Contacts/dv/d126330fb061247d9ebddaeb9d93ba74750b0284bc703b38","createdTime":"2017-10-12T13:11:50.000Z","zohoCRMContact":null,"id":"1892000000772003","isSpam":false,"customerHappiness":{"badPercentage":"0","okPercentage":"0","goodPercentage":"0"},"email":"case@zylker.com"},{"lastName":"Jade","secondaryEmail":null,"ownerId":null,"type":null,"accountId":"1892000000052077","firstName":"Christ","photoURL":null,"phone":null,"webUrl":"https://desk.zoho.com/support/zylker/ShowHomePage.do#Contacts/dv/d126330fb061247d9ebddaeb9d93ba74750b0284bc703b38","createdTime":"2017-10-12T13:11:50.000Z","zohoCRMContact":{"id":"1892000000772030","type":"contacts_leads"},"id":"1892000000772001","isSpam":false,"customerHappiness":{"badPercentage":"22","okPercentage":"31","goodPercentage":"47"},"email":"jade@zylker.com"}]}]}