Update a contact

PATCH {{baseUrl}}/api/v1/contacts/:contact_id

This API updates details of an existing contact.

OAuth Scope

  • Desk.contacts.UPDATE

Attributes

Attribute NameData TypeDescription
customFields<object>
User-defined fields related to the contact
cf<JSONObject>
User-defined fields related to the contact
lastName<string>
max chars : 200
Last name of the contact
firstName<string>
max chars : 100
First name of the contact
facebook<string>
max chars : 300
Facebook ID of the contact
twitter<string>
max chars : 300
Twitter ID of the contact
secondaryEmail<string>
max chars : 100
Secondary email ID of the contact
email<string>
max chars : 255
Email ID of the contact
phone<string>
max chars : 100
Phone number of the contact
mobile<string>
max chars : 100
Mobile number of the contact
city<string>
max chars : 100
Contact's city of residence
country<string>
max chars : 100
Contact's country of residence
state<string>
max chars : 100
Contact's state of residence
street<string>
max chars : 250
Contact's address
zip<string>
max chars : 100
Zip code
description<string>
max chars : 65535
Contact description
title<string>
max chars : 120
Contact title
type<string>
max chars : 120
Contact type
ownerId<long>
ID of the user who creates the contact
accountId<long>
Account to which the contact is mapped

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring

RESPONSES

status: OK

{&quot;lastName&quot;:&quot;john&quot;,&quot;modifiedTime&quot;:&quot;2016-07-26T13:11:02.000Z&quot;,&quot;country&quot;:&quot;USA&quot;,&quot;secondaryEmail&quot;:&quot;stephen@zylker.com&quot;,&quot;city&quot;:&quot;Texas&quot;,&quot;description&quot;:&quot;first priority contact&quot;,&quot;ownerId&quot;:&quot;1892000000056007&quot;,&quot;type&quot;:&quot;paidUser&quot;,&quot;title&quot;:&quot;The contact&quot;,&quot;photoURL&quot;:null,&quot;twitter&quot;:&quot;stephen john&quot;,&quot;isDeleted&quot;:false,&quot;isTrashed&quot;:false,&quot;street&quot;:&quot;East street&quot;,&quot;createdTime&quot;:&quot;2016-07-26T13:11:02.000Z&quot;,&quot;zohoCRMContact&quot;:null,&quot;state&quot;:&quot;Austin&quot;,&quot;id&quot;:&quot;1892000001128052&quot;,&quot;customerHappiness&quot;:{&quot;badPercentage&quot;:&quot;0&quot;,&quot;okPercentage&quot;:&quot;0&quot;,&quot;goodPercentage&quot;:&quot;0&quot;},&quot;email&quot;:&quot;stephent@zylker.com&quot;,&quot;zip&quot;:&quot;123902&quot;,&quot;cf&quot;:{&quot;cf_permanentaddress&quot;:null,&quot;cf_lastcontactedon&quot;:null},&quot;isFollowing&quot;:&quot;true&quot;,&quot;facebook&quot;:&quot;Steve john&quot;,&quot;mobile&quot;:&quot;+129737289298&quot;,&quot;accountId&quot;:&quot;1892000000052077&quot;,&quot;firstName&quot;:&quot;Stephen&quot;,&quot;isAnonymous&quot;:&quot;false&quot;,&quot;phone&quot;:&quot;8981901921&quot;,&quot;webUrl&quot;:&quot;https://desk.zoho.com/support/zylker/ShowHomePage.do#Contacts/dv/d126330fb061247d9ebddaeb9d93ba74750b0284bc703b38&quot;,&quot;isSpam&quot;:false}