Convert Lead in Zoho CRM
n8n-nodes-base.httpRequest
Convert a lead into a contact, account, and optionally a deal in Zoho CRM
💡 Use Cases
- Convert qualified leads to contacts
- Create accounts from lead companies
- Generate deals from converted leads
- Automate lead qualification workflow
📚 API Documentation
Reference documentation for this API endpoint:
🔗 https://www.zoho.com/crm/developer/docs/api/v8/convert-lead.html ↗📋 Node Configuration
{
"nodes": [
{
"parameters": {
"content": "## 🔄 Convert Lead in Zoho CRM\n\n**Usage:**\nConvert a lead into a contact, account, and optionally a deal.\n\n**Required Input:**\n- `leadId`: ID of the lead to convert\n\n**Optional Fields:**\n- `overwrite`: Overwrite existing records (default: false)\n- `notify_lead_owner`: Notify lead owner (default: true)\n- `notify_new_entity_owner`: Notify new entity owner\n- `Deals`: Deal object to create (Deal_Name, Amount, Stage, Closing_Date)\n- `Accounts`: Account details override\n- `Contacts`: Contact details override\n\n**Setup:**\n1. Configure Zoho OAuth2 credentials\n2. Provide the lead ID\n3. Optionally configure deal creation\n\n**Output:**\nReturns IDs of created Contact, Account, and Deal",
"height": 238,
"width": 389,
"color": 4
},
"type": "n8n-nodes-base.stickyNote",
"position": [
96,
332
],
"typeVersion": 1,
"id": "sticky-zoho-crm-convert-lead",
"name": "Sticky Note"
},
{
"parameters": {
"method": "POST",
"url": "=https://www.zohoapis.com/crm/v8/Leads/{{ $json.leadId }}/actions/convert",
"authentication": "genericCredentialType",
"genericAuthType": "oAuth2Api",
"sendHeaders": true,
"headerParameters": {
"parameters": [
{
"name": "Content-Type",
"value": "application/json"
}
]
},
"sendBody": true,
"specifyBody": "json",
"jsonBody": "={\n \"data\": [\n {\n \"overwrite\": {{ $json.overwrite || false }},\n \"notify_lead_owner\": {{ $json.notify_lead_owner !== false }},\n \"notify_new_entity_owner\": {{ $json.notify_new_entity_owner || false }}{{ $json.Deals ? ',\\n \"Deals\": ' + JSON.stringify($json.Deals) : '' }}{{ $json.Accounts ? ',\\n \"Accounts\": ' + JSON.stringify($json.Accounts) : '' }}{{ $json.Contacts ? ',\\n \"Contacts\": ' + JSON.stringify($json.Contacts) : '' }}\n }\n ]\n}",
"options": {
"response": {
"response": {
"responseFormat": "json"
}
}
}
},
"id": "node-zoho-crm-convert-lead",
"name": "Convert Zoho CRM Lead",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4.1,
"position": [
368,
400
],
"credentials": {
"oAuth2Api": {
"id": "zoho-oauth2",
"name": "Zoho OAuth2 API"
}
}
}
],
"connections": {},
"pinData": {},
"meta": {
"templateCredsSetupCompleted": true,
"instanceId": "zoho-crm-convert-lead-001"
}
}
[
{
"id": "c64ee404-1537-4db6-af14-2ccb5144b6f0",
"meta": {
"name": "API Call Node",
"id": "api-call",
"icon": {
"svg": "
{
"subflows": [
{
"flow": [
{
"id": 533,
"module": "http:ActionSendDataBasicAuth",
"version": 3,
"parameters": {
"key": "ANONYMIZED_CREDENTIALS",
"handleErrors": false,
"useNewZLibDeCompress": true
},
"mapper": {
"ca": "",
"qs": [],
"url": "https://www.zohoapis.com/crm/v8/Leads/{{1.leadId}}/actions/convert",
"data": "{\n \"data\": [\n {\n \"overwrite\": {{ $json.overwrite || false }},\n \"notify_lead_owner\": {{ $json.notify_lead_owner !== false }},\n \"notify_new_entity_owner\": {{ $json.notify_new_entity_owner || false }}{{ $json.Deals ? ',\\n \"Deals\": ' + JSON.stringify($json.Deals) : '' }}{{ $json.Accounts ? ',\\n \"Accounts\": ' + JSON.stringify($json.Accounts) : '' }}{{ $json.Contacts ? ',\\n \"Contacts\": ' + JSON.stringify($json.Contacts) : '' }}\n }\n ]\n}",
"gzip": true,
"method": "post",
"headers": [
{
"name": "Content-Type",
"value": "application/json"
},
{
"name": "Authorization",
"value": "Bearer {{ANONYMIZED_TOKEN}}"
}
],
"timeout": "",
"useMtls": false,
"bodyType": "raw",
"contentType": "application/json",
"serializeUrl": false,
"shareCookies": false,
"parseResponse": true,
"followRedirect": true,
"useQuerystring": false,
"followAllRedirects": false,
"rejectUnauthorized": true
},
"metadata": {
"designer": {
"x": 300,
"y": 300,
"name": "Convert Lead in Zoho CRM"
},
"restore": {
"expect": {
"qs": {
"mode": "chose",
"items": []
},
"method": {
"mode": "chose",
"label": "POST"
},
"headers": {
"mode": "chose",
"items": [
null,
null
]
},
"bodyType": {
"label": "Raw"
},
"contentType": {
"label": "JSON (application/json)"
}
},
"parameters": {
"key": {
"label": "ANONYMIZED_CREDENTIALS"
}
}
},
"parameters": [
{
"name": "key",
"type": "keychain:basicauth",
"label": "Credentials",
"required": true
},
{
"name": "handleErrors",
"type": "boolean",
"label": "Evaluate all states as errors (except for 2xx and 3xx )",
"required": true
},
{
"name": "useNewZLibDeCompress",
"type": "hidden"
}
],
"expect": [
{
"name": "url",
"type": "url",
"label": "URL",
"required": true
},
{
"name": "serializeUrl",
"type": "boolean",
"label": "Serialize URL",
"required": true
},
{
"name": "method",
"type": "select",
"label": "Method",
"required": true,
"validate": {
"enum": [
"get",
"head",
"post",
"put",
"patch",
"delete",
"options"
]
}
},
{
"name": "headers",
"spec": [
{
"name": "name",
"type": "text",
"label": "Name",
"required": true
},
{
"name": "value",
"type": "text",
"label": "Value"
}
],
"type": "array",
"label": "Headers"
},
{
"name": "qs",
"spec": [
{
"name": "name",
"type": "text",
"label": "Name",
"required": true
},
{
"name": "value",
"type": "text",
"label": "Value"
}
],
"type": "array",
"label": "Query String"
},
{
"name": "bodyType",
"type": "select",
"label": "Body type",
"validate": {
"enum": [
"raw",
"x_www_form_urlencoded",
"multipart_form_data"
]
}
},
{
"name": "parseResponse",
"type": "boolean",
"label": "Parse response",
"required": true
},
{
"name": "contentType",
"type": "select",
"label": "Content type",
"validate": {
"enum": [
"text/plain",
"application/json",
"application/xml",
"text/xml",
"text/html",
"custom"
]
}
},
{
"name": "data",
"type": "buffer",
"label": "Request content"
}
]
}
}
]
}
],
"metadata": {
"version": 1
}
}