lianja / Zoho CRM REST APIs / Associating a Contact and a Deal using their external IDs
Back to Collection Items
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
loHttp = createobject("CkHttp")
// Use this online tool to generate code from sample JSON: Generate Code to Create JSON
// The following JSON is sent in the request body.
// {
// "data": [
// {
// "External_Deal_ID": "extdeal3",
// "Contact_Role": "111111000000026002"
// }
// ]
// }
loJson = createobject("CkJsonObject")
loJson.UpdateString("data[0].External_Deal_ID","extdeal3")
loJson.UpdateString("data[0].Contact_Role","111111000000026002")
// Adds the "Authorization: Bearer <access_token>" header.
loHttp.AuthToken = "<access_token>"
loHttp.SetRequestHeader("X-EXTERNAL","Contacts.External_Contact_ID,Deals.External_Deal_ID")
loSbRequestBody = createobject("CkStringBuilder")
loJson.EmitSb(loSbRequestBody)
loResp = loHttp.PTextSb("PUT","https://domain.com/crm/v2/Contacts/extcontact3/Deals",loSbRequestBody,"utf-8","application/json",.F.,.F.)
if (loHttp.LastMethodSuccess = .F.) then
? loHttp.LastErrorText
release loHttp
release loJson
release loSbRequestBody
return
endif
? str(loResp.StatusCode)
? loResp.BodyStr
release loResp
release loHttp
release loJson
release loSbRequestBody
Curl Command
curl -X PUT
-H "Authorization: Bearer <access_token>"
-H "X-EXTERNAL: Contacts.External_Contact_ID,Deals.External_Deal_ID"
-d '{
"data": [
{
"External_Deal_ID": "extdeal3",
"Contact_Role": "111111000000026002"
}
]
}'
https://domain.com/crm/v2/Contacts/extcontact3/Deals
Postman Collection Item JSON
{
"name": "Associating a Contact and a Deal using their external IDs",
"request": {
"auth": {
"type": "bearer",
"bearer": [
{
"key": "token",
"value": "{{access-token}}",
"type": "string"
}
]
},
"method": "PUT",
"header": [
{
"key": "X-EXTERNAL",
"value": "Contacts.External_Contact_ID,Deals.External_Deal_ID",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"data\": [\n {\n \"External_Deal_ID\": \"extdeal3\",\n \"Contact_Role\": \"111111000000026002\"\n }\n ]\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "{{api-domain}}/crm/v2/Contacts/extcontact3/Deals",
"host": [
"{{api-domain}}"
],
"path": [
"crm",
"v2",
"Contacts",
"extcontact3",
"Deals"
]
},
"description": "In this example, extcontact3 and extdeal3 are the values of the external fields External_Contact_ID and External_Deal_ID in the Contacts and Deals modules, respectively. We will reference these values to associate the contact with the deal."
},
"response": [
]
}