Zoho Deluge — Quick Reference

Deluge Syntax Fundamentals — Variables, Maps, Conditionals, Loops

// 1. VARIABLES — assign any value type without declaration
dealId = input.get("deal_id");        // String from workflow input
threshold = 50000;                     // Number
isActive = true;                       // Boolean

// 2. MAPS — Deluge's key-value data structure (critical for CRM updates)
// "Deluge script map manipulation" — most used pattern
updateMap = Map();
updateMap.put("Priority", "High");
updateMap.put("Stage", "Proposal");
updateMap.put("Custom_Field", "Value");

// 3. LISTS — collection of values
emailList = List();
emailList.add("sales@company.com");
emailList.add("manager@company.com");

// 4. CONDITIONAL STATEMENTS
deal = zoho.crm.getRecordById("Deals", dealId);
amount = deal.get("Amount");

if(amount > threshold)
{
  updateMap.put("Priority", "High");
  info "High priority deal: " + dealId;
}
else
{
  updateMap.put("Priority", "Normal");
}

// 5. FOR-EACH LOOP — iterate over search results
contacts = zoho.crm.searchRecords("Contacts", "Account_Name:equals:Acme Corp");
for each contact in contacts
{
  info contact.get("Email");
}

1
Update Deal Priority Based on Amount Threshold

Deluge script update records CRM | Write first Deluge script CRM

The most common starting point for any write first Deluge script CRM tutorial — conditionally update a CRM field based on a value comparison.

// INPUT PARAMETERS: deal_id (String)
// TRIGGER: On Deal edit/create
// PURPOSE: Set priority based on deal amount

dealId = input.get("deal_id");
deal = zoho.crm.getRecordById("Deals", dealId);

amount = deal.get("Amount").toDecimal();
info "Deal amount: " + amount;

updateMap = Map();

if(amount > 500000)
{
  updateMap.put("Priority", "Critical");
  updateMap.put("Sales_Rep_Note", "Escalate to senior sales immediately");
}
else if(amount > 100000)
{
  updateMap.put("Priority", "High");
}
else if(amount > 50000)
{
  updateMap.put("Priority", "Medium");
}
else
{
  updateMap.put("Priority", "Low");
}

// Deluge script update records CRM
response = zoho.crm.updateRecord("Deals", dealId, updateMap);
info "Update response: " + response;

2
Send Email Notification with Dynamic CRM Data

CRM automation Deluge | Zoho automation email trigger

// INPUT PARAMETERS: lead_id (String)
// TRIGGER: On Lead creation
// PURPOSE: Notify sales team with lead details

leadId = input.get("lead_id");
lead = zoho.crm.getRecordById("Leads", leadId);

leadName = lead.get("Full_Name");
company = lead.get("Company");
phone = lead.get("Phone");
source = lead.get("Lead_Source");

emailBody = "New lead received:

";
emailBody = emailBody + "Name: " + leadName + "
";
emailBody = emailBody + "Company: " + company + "
";
emailBody = emailBody + "Phone: " + phone + "
";
emailBody = emailBody + "Source: " + source + "

";
emailBody = emailBody + "Log into CRM to follow up immediately.";

sendmail
[
  from   : zoho.adminuserid
  to     : "sales@yourcompany.com"
  cc     : "manager@yourcompany.com"
  subject: "New Lead: " + leadName + " (" + company + ")"
  message: emailBody
]

// Update lead status
statusMap = Map();
statusMap.put("Lead_Status", "Contacted");
zoho.crm.updateRecord("Leads", leadId, statusMap);

3
Fetch and Update Multiple Related Contact Records

Deluge script fetch records tutorial | Custom CRM automation Deluge

// INPUT PARAMETERS: account_id (String)
// TRIGGER: On Account field change (e.g., Account_Status changed to Inactive)
// PURPOSE: Update all contacts under account to Inactive

accountId = input.get("account_id");

// Search all contacts linked to this account
// Custom Deluge functions Zoho CRM - search pattern
contactList = zoho.crm.getRelatedRecords("Contacts", "Accounts", accountId);

updatedCount = 0;
for each contact in contactList
{
  contactId = contact.get("id");

  contactUpdateMap = Map();
  contactUpdateMap.put("Contact_Status", "Inactive");
  contactUpdateMap.put("Account_Inactive_Date", zoho.currentdate.toString("yyyy-MM-dd"));

  response = zoho.crm.updateRecord("Contacts", contactId, contactUpdateMap);
  updatedCount = updatedCount + 1;
}

info "Total contacts updated: " + updatedCount;

4
Call External API and Write Response Back to CRM

Deluge API | Custom Deluge functions Zoho CRM external integration

// INPUT PARAMETERS: contact_id (String)
// TRIGGER: On Contact creation
// PURPOSE: Verify GST number via external API and store result in CRM

contactId = input.get("contact_id");
contact = zoho.crm.getRecordById("Contacts", contactId);
gstin = contact.get("GSTIN_Number");

if(gstin != null && gstin.length() == 15)
{
  // Call external GST verification API
  apiUrl = "https://api.yourgstsservice.com/verify/" + gstin;

  headerMap = Map();
  headerMap.put("Authorization", "Bearer YOUR_API_KEY");
  headerMap.put("Content-Type", "application/json");

  // Deluge API invokeurl — external REST call
  response = invokeurl
  [
    url       : apiUrl
    type      : GET
    headers   : headerMap
    connection: "gst_api_connection"  // pre-configured connection in Zoho
  ];

  // Parse response map
  gstStatus = response.get("status");
  companyName = response.get("legal_name");

  // Write API result back to CRM contact record
  resultMap = Map();
  resultMap.put("GST_Verification_Status", gstStatus);
  resultMap.put("GST_Verified_Name", companyName);
  resultMap.put("GST_Verified_On", zoho.currentdate.toString("yyyy-MM-dd"));

  zoho.crm.updateRecord("Contacts", contactId, resultMap);
  info "GST verification complete: " + gstStatus;
}
else
{
  info "Invalid or missing GSTIN — skipping verification";
}

5
Deluge Script Map Manipulation — Calculate and Aggregate

Deluge script map manipulation | Deluge code aggregation reporting

// INPUT PARAMETERS: account_id (String)
// TRIGGER: Scheduled daily cron job
// PURPOSE: Calculate total deal value for account and update account record

accountId = input.get("account_id");

// Fetch all open deals for this account
deals = zoho.crm.searchRecords("Deals",
  "(Account_Name:equals:" + accountId + ")AND(Stage:not_equal:Closed Lost)");

// Deluge script map manipulation — aggregate values
totalValue = 0.0;
dealCount = 0;
highestDeal = 0.0;
dealStageMap = Map();

for each deal in deals
{
  dealAmount = deal.get("Amount").toDecimal();
  dealStage = deal.get("Stage");

  totalValue = totalValue + dealAmount;
  dealCount = dealCount + 1;

  if(dealAmount > highestDeal)
  {
    highestDeal = dealAmount;
  }

  // Count deals per stage using map
  currentStageCount = dealStageMap.get(dealStage);
  if(currentStageCount == null)
  {
    dealStageMap.put(dealStage, 1);
  }
  else
  {
    dealStageMap.put(dealStage, currentStageCount + 1);
  }
}

// Write aggregated data back to account
accountUpdate = Map();
accountUpdate.put("Total_Pipeline_Value", totalValue);
accountUpdate.put("Active_Deals_Count", dealCount);
accountUpdate.put("Highest_Deal_Value", highestDeal);
accountUpdate.put("Pipeline_Last_Updated", zoho.currentdate.toString("yyyy-MM-dd"));

zoho.crm.updateRecord("Accounts", accountId, accountUpdate);
info "Pipeline total: " + totalValue + " across " + dealCount + " deals";

6
Write Deluge Script Custom Buttons — On-Demand Actions

Write Deluge script custom buttons | Zoho coding custom button action

// CUSTOM BUTTON function — triggered manually by sales rep on Deal record
// PURPOSE: Send payment link to customer and log the action

dealId = input.get("deal_id");
deal = zoho.crm.getRecordById("Deals", dealId);

contactId = deal.get("Contact_Name").get("id");
contact = zoho.crm.getRecordById("Contacts", contactId);

contactEmail = contact.get("Email");
contactName = contact.get("Full_Name");
dealAmount = deal.get("Amount");

// Build payment link (example: Razorpay payment link API)
paymentRequestBody = Map();
paymentRequestBody.put("amount", (dealAmount * 100).toString()); // in paise
paymentRequestBody.put("currency", "INR");
paymentRequestBody.put("description", "Payment for deal #" + dealId);
paymentRequestBody.put("customer_email", contactEmail);

// Call payment gateway API
paymentResponse = invokeurl
[
  url       : "https://api.razorpay.com/v1/payment_links"
  type      : POST
  parameters: paymentRequestBody.toString()
  connection: "razorpay_connection"
];

paymentLink = paymentResponse.get("short_url");

// Send payment link via email
sendmail
[
  from    : zoho.adminuserid
  to      : contactEmail
  subject : "Payment Link for Your Order"
  message : "Dear " + contactName + ",

Please use this link to complete your payment: " + paymentLink
]

// Log action in deal notes
noteMap = Map();
noteMap.put("Note_Title", "Payment link sent");
noteMap.put("Note_Content", "Payment link sent to " + contactEmail + ". Link: " + paymentLink);
noteMap.put("Parent_Id", Map("id": dealId));
zoho.crm.createRecord("Notes", noteMap);

7
Zoho Deluge Script Best Practices — Error Handling Pattern

Deluge script error handling | Debug Deluge script CRM

// PRODUCTION-GRADE ERROR HANDLING pattern for Deluge scripts
// Always validate inputs, check responses, and log everything

contactId = input.get("contact_id");

// STEP 1: Validate input before processing
if(contactId == null || contactId == "")
{
  info "ERROR: contact_id is null or empty — aborting function";
  return;
}

// STEP 2: Fetch record with null check
contact = zoho.crm.getRecordById("Contacts", contactId);

if(contact == null || contact.isEmpty())
{
  info "ERROR: Contact record not found for ID: " + contactId;
  return;
}

// STEP 3: Extract field with default fallback
phone = contact.get("Phone");
if(phone == null || phone == "")
{
  phone = "No phone on record";
  info "WARNING: Contact " + contactId + " has no phone number";
}

// STEP 4: Check API response for errors before trusting data
updateMap = Map();
updateMap.put("Contact_Status", "Verified");
response = zoho.crm.updateRecord("Contacts", contactId, updateMap);

// STEP 5: Verify update succeeded — response contains "data" on success
if(response.get("data") != null)
{
  info "SUCCESS: Contact " + contactId + " updated successfully";
}
else
{
  info "ERROR: Update failed for contact " + contactId;
  info "Response details: " + response.toString();
}

More Guides from Codroid Labs

• Zoho CRM API Tutorial — OAuth 2.0 and REST Integration Complete Guide
• Zoho CRM Workflow Automation — 10 Powerful Workflows to Set Up Today
• Are You Using Zoho Bigin Wrong? 10 Costly Errors 2026
• Zoho Implementation Partner in India — 8 Questions to Ask Before Choosing

What is Deluge scripting in Zoho CRM?

Deluge script for CRM workflows is Zoho’s proprietary scripting language for automating business processes inside Zoho CRM and the wider Zoho ecosystem. It enables custom business logic beyond standard workflow rules — conditional field updates, multi-record operations, external API calls, data aggregation, and document process automation. It executes server-side within Zoho’s infrastructure with no runtime to configure.

How do I create a custom function in Zoho CRM with Deluge?

To create Deluge function step by step: Go to Setup > Developer Space > Functions > Create Function. Choose function type (Standalone or Workflow-based). Define input parameters. Write the Deluge script for CRM workflows in the built-in editor. Test with sample data using info debug statements. Then attach to a Workflow Rule by adding Custom Function as a workflow action and mapping field values to parameters.

Is Deluge similar to JavaScript or Python?

The Zoho Deluge vs JavaScript CRM comparison shows both use curly braces and conditionals, but Deluge is significantly simpler for CRM-specific tasks — no async/await, no prototype chains, no DOM. Deluge shares Python’s readability but does not use indentation for code blocks. For Zoho CRM automation, Deluge is the more practical choice over JavaScript because its built-in functions (zoho.crm.getRecordById, sendmail, invokeurl) are designed specifically for CRM operations.

What are Deluge script execution limits?

Zoho Deluge script execution limits: maximum execution time 5 minutes per function call, individual API call timeout approximately 40 seconds, and file size limit 20MB. The Zoho Deluge script best practices guide recommends keeping functions well under the time limit, using scheduled Cron functions with pagination for large datasets, and splitting complex operations into multiple chained functions.

How do I learn Deluge scripting for CRM?

To learn Deluge scripting for CRM: Start with the 7 code examples in this guide — each covers a distinct pattern (update, fetch, multi-record, API call, aggregation, custom button, error handling). Use the Zoho Deluge documentation at zoho.com/deluge/help for the complete function reference. Practice by modifying the examples to match your own CRM data model. For complex implementations, Codroid Labs offers Deluge scripting consultation and custom function development. Contact team@codroiditlabs.com or +91 78384 02682.

Need a Zoho Script, Workflow Script, Deluge Tasks, or Zoho Functions? Need Custom Deluge Functions for Your Zoho CRM?

Codroid Labs — certified Zoho partner with expert Deluge scripting capability. Custom workflow functions, API integrations, Blueprint automation, document workflow automation, and complete CRM customisation. Fixed price. GST invoice. Hindi or English.

Start Free Zoho CRM Trial

Book Free Deluge Scripting Consultation