Zoho CRM

1. Overview

Zoho CRM is a comprehensive cloud-based Customer Relationship Management (CRM) platform that helps businesses manage their sales, marketing, customer support, and inventory operations. It provides tools for lead management, contact organization, deal tracking, sales automation, and detailed analytics.

Through the GoInsight Zoho CRM node, you can seamlessly integrate CRM operations into your automated workflows. You can manage the full lifecycle of your sales data, including:

• Create and manage leads, contacts, accounts, and deals
• Track and update sales opportunities, quotes, and orders
• Search and retrieve CRM records with flexible filtering
• Organize products, invoices, and vendor information
• Extend functionality with custom modules and field management

2. Prerequisites

Before using this node, you need to have a valid Zoho CRM account. You may need administrator permissions to create and manage API credentials and OAuth applications.

3. Credentials

For detailed guidance on how to obtain and configure credentials, please refer to our official documentation: Credentials Configuration Guide.

4. Supported Operations

Summary

This node primarily operates on the following resources: Account, Contact, Custom Module, Deal, Invoice, Lead, Module, Product, Purchase Order, Quote, Sales Order, and Vendor.

Operation Details

Create an Account

Creates an account (company/organization) in Zoho CRM. Use for new accounts only, not updates.

Input Parameters:

• AccountName: The company name (required). This is the primary identifier and is used for duplicate checking. Maximum 200 characters. Example: Acme Corporation

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• Website: The company website URL (optional). Must be a valid URL starting with http:// or https://. Example: https://www.example.com
• Phone: The main phone number (optional). Accepts any format including international. Example: +1-555-123-4567
• BillingCity: The billing city (optional). Example: San Francisco
• AdditionalFields: Additional account fields as an object (optional). Use Zoho CRM field API names as keys. Refer to Zoho CRM API documentation for field-specific data type requirements. Example: {"Industry": "Technology", "Annual_Revenue": 1000000}
• DuplicateCheckFields: Comma-separated field names for duplicate checking (optional). If a matching record exists, creation will be skipped. Common fields: Account_Name, Website, Phone. Leave empty to use Account_Name by default. Example: Account_Name or Account_Name,Website

Output:

• CreatedAccount (object): The created account object containing id, Account_Name, Website, Phone, Billing_City, Created_Time, Modified_Time, and Owner.
• OriginalStatusCode (number): The raw HTTP status code returned by the Zoho CRM API (e.g., 200 for success, 429 for rate limited, 400 for bad request).
• StatusCode (number): Operation result code: 200 (success or business error, check ErrorMessage), -1 (parameter validation error), 500 (system/network error).
• ErrorMessage (string): Detailed error description. Empty string when successful. When rate limited (429), includes retry wait time.

Create or Update an Account

Creates or updates an Account in Zoho CRM using upsert.

Input Parameters:

• AccountName: The company name (required). Used for duplicate checking by default. Example: Acme Corporation

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• Website: The company website URL (optional). Example: https://www.example.com
• Phone: The main phone number (optional). Example: +1-555-123-4567
• BillingCity: The billing city (optional). Example: San Francisco
• AccountId: The ID of the account to update (optional). If provided, updates this specific account directly, bypassing duplicate check. You can obtain this ID from Search Accounts or Get Many Accounts action. Example: 3652397000000624001
• AdditionalFields: Additional account fields as an object (optional). Use Zoho CRM field API names as keys. Refer to Zoho CRM API documentation for field-specific data type requirements. Example: {"Industry": "Technology", "Annual_Revenue": 1000000}
• DuplicateCheckFields: Comma-separated field names for duplicate checking (optional). If a matching record exists, Zoho updates it instead of creating a duplicate. Leave empty to use Account_Name by default. Example: Account_Name or Account_Name,Website

Output:

• CreatedOrUpdatedAccount (object): The created or updated account object containing id, Account_Name, Website, Phone, Billing_City, Created_Time, Modified_Time, and Owner.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (duplicates, validation, rate limits), or system error info.

Delete an Account

Permanently deletes an Account from Zoho CRM.

Input Parameters:

• AccountId: The ID of the account to delete (required). You can obtain this ID from Search Accounts or Get Many Accounts action. Example: 3652397000000624001

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).

Output:

• DeletedAccount (object): The deleted account object containing id (account identifier) and status ("deleted").
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (not found, validation, rate limits), or system error info.

Get an Account

Retrieves an Account from Zoho CRM by ID.

Input Parameters:

• AccountId: The ID of the account to retrieve (required). You can obtain this ID from Search Accounts or Get Many Accounts action. Example: 3652397000000624001

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• AdditionalFields: Comma-separated field names to include in result beyond default fields. Use Zoho CRM field API names. Example: Industry,Annual_Revenue,Employees

Output:

• Account (object): The account object containing id, Account_Name, Phone, Website, Owner, Created_Time, Modified_Time, and any fields specified in AdditionalFields.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (not found, validation, rate limits), or system error info.

Get Many Accounts

Retrieves multiple accounts from Zoho CRM with pagination support.

Options:

• ZohoUrl: Zoho CRM API server address. Most users should keep the default value. Change only if your data is hosted in a specific region: Europe (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in), or Australia (https://www.zohoapis.com.au). Example: https://www.zohoapis.com
• PerPage: Number of accounts per page (1-200). Default: 200
• Page: Page number for pagination (starts at 1). Default: 1
• AdditionalFields: List of extra fields to retrieve, separated by commas without spaces. Use the exact API Names (case-sensitive). Common fields: Industry, Annual_Revenue, No_of_Employees, Rating. You can find these API Names in Zoho CRM Setup > Developer Space > APIs > API Names. Example: Industry,Annual_Revenue,No_of_Employees

Output:

• Accounts (object-array): Array of account objects. Each object includes: id (string): Unique identifier; Account_Name (string): Name of the account; Phone (string): Primary contact number; Website (string): Company URL; Owner (object): Contains id and name of the record owner; Created_Time/Modified_Time (string): ISO 8601 timestamps; plus any fields specified in AdditionalFields.
• Info (object): Pagination metadata: count (number): Records in current page; more_records (boolean): Whether more pages exist; per_page (number): Records per page; page (number): Current page index.
• OriginalStatusCode (number): The raw HTTP status code returned by the Zoho CRM API (e.g., 200 for success, 429 for rate limited).
• StatusCode (number): Operation result code: 200 (success), -1 (parameter error), 500 (system error). Note: API business errors (like 400, 429) return StatusCode 200 with details in ErrorMessage and OriginalStatusCode.
• ErrorMessage (string): Detailed error description. Empty string when successful. When rate limited (429), includes retry wait time.

Search Accounts

Searches accounts in Zoho CRM using advanced criteria, email, phone, or keyword.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• Criteria: ⚠️ Priority 1 - Advanced search expression. MUTUALLY EXCLUSIVE with Email/Phone/Keyword (if provided, others are ignored). Format: (Field:Operator:Value). Operators: equals, starts_with, contains, greater_than, less_than. Combine with 'and'/'or'. Examples: (Account_Name:starts_with:ABC) or (Account_Name:starts_with:ABC)and(Industry:equals:Technology). Leave empty to use Email/Phone/Keyword.
• Email: ⚠️ Priority 2 - Search by exact email match. MUTUALLY EXCLUSIVE with Criteria/Phone/Keyword. Only used if Criteria is empty. Example: info@example.com. Leave empty to use Phone or Keyword.
• Phone: ⚠️ Priority 3 - Search by exact phone match. MUTUALLY EXCLUSIVE with Criteria/Email/Keyword. Only used if Criteria and Email are empty. Example: +1-555-123-4567. Leave empty to use Keyword.
• Keyword: ⚠️ Priority 4 - Fuzzy keyword search across multiple fields. MUTUALLY EXCLUSIVE with Criteria/Email/Phone. Only used if all others are empty. Example: Technology. ⚠️ Use only ONE search method at a time.
• PerPage: Number of accounts per page (1-200). Default: 200
• Page: Page number for pagination (starts at 1). Default: 1
• AdditionalFields: Comma-separated field names to include in results. Use Zoho CRM field API names. Example: Industry,Annual_Revenue,Employees

Output:

• Accounts (object-array): List of accounts matching search criteria, containing id, Account_Name, Phone, Website, Owner, Created_Time, Modified_Time, and any fields specified in AdditionalFields.
• Info (object): Pagination metadata containing count (records in current page), more_records (boolean), per_page (records per page), page (current page number).
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 204, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (invalid criteria, rate limits), or system error info.

Update an Account

Updates an existing Account in Zoho CRM.

Input Parameters:

• AccountId: The ID of the account to update (required). You can obtain this ID from Search Accounts or Get Many Accounts action. Example: 3652397000000624001

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• AccountName: The new account name (optional). Example: Acme Corporation
• Website: The new website URL (optional). Must include http:// or https://. Example: https://www.example.com
• Phone: The new phone number (optional). Supports international format. Example: +1-555-123-4567
• BillingCity: The new billing city (optional). Example: San Francisco
• AdditionalFields: Additional account fields as an object (optional). Use Zoho CRM field API names as keys. Example: {"Industry": "Technology", "Annual_Revenue": 1000000}

Output:

• UpdatedAccount (object): The updated account object containing id, Account_Name, Website, Phone, Billing_City, Created_Time, Modified_Time, and Owner.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (invalid ID, validation failures, rate limits), or system error info.

Create a Contact

Creates a new contact in Zoho CRM.

Input Parameters:

• LastName: The last name (family name) of the contact (required). This is the mandatory field for creating a contact in Zoho CRM. Example: Smith, Zhang.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region:
• Europe: https://www.zohoapis.eu
• China: https://www.zohoapis.com.cn
• India: https://www.zohoapis.in
• Australia: https://www.zohoapis.com.au

Contact your Zoho CRM administrator if unsure. Default: https://www.zohoapis.com

• FirstName: The first name (given name) of the contact (optional). Example: John, Wei.
• Email: The primary email address of the contact (optional). Format: user@domain.com. Commonly used for duplicate checking. Example: john.smith@company.com
• Phone: The phone number of the contact (optional). Accepts any format. Example: +1-555-123-4567
• AdditionalFields: Extended fields (key-value pairs). Use this for non-core fields other than Name, Email, or Phone. Common fields:
• Title: Job title (e.g., Marketing Manager)
• Department: Department name (e.g., Sales)
• Account_Name: Associated company name
• Mailing_Street: Street address
• Description: Notes
• Lead_Source: Source of the lead (e.g., Web Form)

Example: {"Title": "CEO", "Department": "Executive", "Account_Name": "Acme Corp"}

• DuplicateCheckFields: Fields to check for duplicates (comma-separated, optional). Strongly recommended to set 'Email' or 'Phone' to ensure idempotency (prevents duplicate records on network retries). If a matching record exists, Zoho returns an error. Leave empty to skip duplicate check (allows duplicates). Common values: Email, Phone. Default: Email

Output:

• CreatedContact (object): The created contact object containing core fields:
• id (string): Unique identifier
• First_Name (string): First name
• Last_Name (string): Last name
• Email (string): Email address
• Phone (string): Phone number
• Created_Time (string): Creation time in ISO 8601 format
• Modified_Time (string): Last modification time
• Owner (object): Owner info containing id and name
• OriginalStatusCode (number): The raw HTTP status code returned by the Zoho API (e.g., 201 for created, 400 for bad request).
• StatusCode (number): System operation status code. 200 = system healthy (including API business errors), 500 = system error, -1 = parameter validation error.
• ErrorMessage (string): Error description. Empty string if successful.

Create or Update a Contact

Creates or updates a contact in Zoho CRM, automatically handling duplicates.

Input Parameters:

• LastName: The last name (family name) of the contact (required). This is the mandatory field for creating or updating a contact in Zoho CRM. Example: Smith, Zhang.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if your Zoho account is registered in a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in). Example: https://www.zohoapis.com
• FirstName: The first name (given name) of the contact (optional). Example: John, Wei.
• Email: The primary email address of the contact (optional). Format: user@domain.com. This field is used for duplicate checking when updating. Example: john.smith@company.com
• Phone: The phone number of the contact (optional). Accepts any format. Example: +1-555-123-4567
• ContactId: The ID of the contact to update (optional). If provided, updates this specific contact directly. You can obtain this ID from Search_Contacts or Get_Many_Contacts action. Example: 3652397000000624001
• AdditionalFields: Additional contact fields as an object (optional). Use Zoho CRM field API names as keys. Refer to Zoho CRM API documentation for field-specific data type requirements. Example: {"Title": "CEO", "Department": "Executive"}
• DuplicateCheckFields: Comma-separated field names for duplicate check (optional). This prevents creating duplicate contacts by checking if a record with the same field values already exists. If found, Zoho updates it instead of creating a new one. Example: Email or Email,Phone

Output:

• CreatedOrUpdatedContact (object): The created or updated contact object. Core fields: id (string): Unique contact identifier; First_Name (string): Given name; Last_Name (string): Family name; Email (string): Primary email address; Phone (string): Phone number; Created_Time (string): ISO 8601 timestamp; Modified_Time (string): ISO 8601 timestamp; Owner (object): Owner info with id (string) and name (string).
• OriginalStatusCode (number): The raw HTTP status code returned by the Zoho CRM API (e.g., 200, 201, 400).
• StatusCode (number): Operation result code: 200 (success), -1 (parameter error), 429 (rate limited), 504 (timeout), 503 (connection error), or HTTP status code.
• ErrorMessage (string): Detailed error description. Empty string when successful. When rate limited (429), includes retry wait time.

Delete a Contact

Permanently deletes a contact from Zoho CRM.

Input Parameters:

• ContactId: The ID of the contact to delete (required). This is an 18-digit numeric identifier. You can obtain it from Search Contacts or Get Many Contacts action. Example: "3652397000000624001"

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).

Output:

• DeletedContact (object): The deleted contact object. Fields: id (string, 18-digit identifier), status (string, fixed value "deleted").
• OriginalStatusCode (number): The original HTTP status code returned by the upstream API. Default 0 means the request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation status code: 200=Success (check ErrorMessage for business errors), -1=Parameter validation error, 500=System error (may retry).
• ErrorMessage (string): Detailed error message if any error occurred. Empty string if the operation succeeded.

Get a Contact

Retrieves a single contact from Zoho CRM by ID.

Input Parameters:

• ContactId: The ID of the contact to retrieve (required). You can obtain this ID from Search Contacts or Get Many Contacts action. Example: 3652397000000624001

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• AdditionalFields: Comma-separated list of Zoho CRM field API names to include in the result beyond default fields. If unsure about field names, call 'Get Contact Fields' action first. Common fields: Title (Job title), Department, Mobile, Assistant, Date_of_Birth. Example: "Title,Department,Mobile"

Output:

• Contact (object): The contact object containing: id (string): Unique identifier; First_Name (string); Last_Name (string); Email (string); Phone (string); Owner (object): Contains 'id' and 'name' of the record owner; Created_Time (string): ISO 8601 format (e.g., 2024-01-15T10:30:00+08:00); Modified_Time (string): ISO 8601 format. Includes any fields specified in AdditionalFields.
• OriginalStatusCode (number): The original HTTP status code returned by Zoho API. Default 0 means the request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation status code: 200=Success (check ErrorMessage for business errors), -1=Parameter validation error, 500=System error (may retry).
• ErrorMessage (string): Detailed error description. Empty string when successful. When rate limited (429), includes retry wait time.

Get Many Contacts

Retrieves a list of contacts from Zoho CRM in bulk or with pagination.

Options:

• ZohoUrl: Zoho CRM API base URL. Usually no need to change (default is US region). Only modify if using other regions: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in). Example: "https://www.zohoapis.com"
• PerPage: Number of contacts per page (1-200). Default: 200
• Page: Page number for pagination (starts at 1). To check if more pages exist, refer to Info.more_records in the response. Example: 1
• AdditionalFields: Comma-separated field API names to include (no spaces). Format: Field1,Field2. Common fields: Title, Department, Mobile, Skype_ID. If unsure of field names, call Get_Contact_Fields action first. Example: "Title,Department,Mobile"

Output:

• Contacts (object-array): Array of contact objects. Each contact contains: id (string), First_Name (string), Last_Name (string), Email (string), Phone (string), Owner (object with id and name), Created_Time (string, ISO 8601), Modified_Time (string, ISO 8601), and any fields requested in AdditionalFields.
• Info (object): Pagination metadata: count (number) - records in current page; more_records (boolean) - true if next page exists; per_page (number) - records per page; page (number) - current page number.
• OriginalStatusCode (number): The raw HTTP status code returned by the Zoho API.
• StatusCode (number): Operation result code: 200 (success), -1 (parameter error), 429 (rate limited), 504 (timeout), 503 (connection error), or HTTP status code.
• ErrorMessage (string): Detailed error description. Empty string when successful. When rate limited (429), includes retry wait time.

Search Contacts

Searches contacts in Zoho CRM using advanced criteria, email, phone, or keyword.

Options:

• ZohoUrl: Zoho CRM API base URL. Usually requires no modification (defaults to US region).

Change only for other regions:

• Europe: https://www.zohoapis.eu
• China: https://www.zohoapis.com.cn
• India: https://www.zohoapis.in
• Australia: https://www.zohoapis.com.au
• Criteria: ⚠️ Priority 1 - Advanced search expression. MUTUALLY EXCLUSIVE with Email/Phone/Keyword (if provided, others are ignored). Format: (Field:Operator:Value). Operators: equals, starts_with, contains, greater_than, less_than. Combine with 'and'/'or'. Examples: (Last_Name:starts_with:Zhang) or (Last_Name:starts_with:Zhang)and(Email:contains:@company.com) or (Created_Time:greater_than:2024-01-01T00:00:00+08:00). Leave empty to use Email/Phone/Keyword instead.
• Email: ⚠️ Priority 2 - Search by exact email match. MUTUALLY EXCLUSIVE with Criteria/Phone/Keyword. Only used if Criteria is empty. Example: john.smith@company.com. Leave empty to use Phone or Keyword.
• Phone: ⚠️ Priority 3 - Search by exact phone match. MUTUALLY EXCLUSIVE with Criteria/Email/Keyword. Only used if Criteria and Email are empty. Example: +1-555-123-4567. Leave empty to use Keyword.
• Keyword: ⚠️ Priority 4 - Fuzzy keyword search across multiple fields. MUTUALLY EXCLUSIVE with Criteria/Email/Phone. Only used if all others are empty. Example: Zhang. ⚠️ Use only ONE search method at a time.
• PerPage: Number of contacts per page (1-200). Default: 200
• Page: Page number for pagination (starts at 1). Default: 1
• AdditionalFields: Format: Comma-separated list of field API names. Specify additional fields to be returned in the Contacts array. Use Zoho CRM API names. Example: "Title,Department,Mobile"

Output:

• Contacts (object-array): Array of matching contact objects. Each object includes:
• id (string): Unique contact identifier
• First_Name (string): Contact's first name
• Last_Name (string): Contact's last name
• Email (string): Primary email address
• Phone (string): Primary phone number
• Owner (object): Record owner details (id, name)
• Created_Time (string): ISO 8601 creation timestamp
• Modified_Time (string): ISO 8601 last modification timestamp
• [AdditionalFields]: Any extra fields requested via the AdditionalFields input parameter
• Info (object): Pagination metadata object:
• count (number): Number of records in the current page
• more_records (boolean): Whether more records are available in subsequent pages
• per_page (number): Number of records requested per page
• page (number): Current page index
• OriginalStatusCode (number): The raw HTTP status code returned by the Zoho CRM API (e.g., 200 for success, 204 for no content, 400 for bad request).
• StatusCode (number): System operation status code. 200 = system healthy (including API business errors), 500 = system error, -1 = parameter validation error, 429 = rate limited.
• ErrorMessage (string): Detailed error description. Empty string when successful. When rate limited (429), includes retry wait time.

Update a Contact

Updates an existing contact in Zoho CRM.

Input Parameters:

• ContactId: The ID of the contact to update (required). You can obtain this ID from Search Contacts, Get Many Contacts, or Create Contact action response. Example: 3652397000000624001

Options:

• ZohoUrl: The API base URL for your Zoho CRM region (e.g., https://www.zohoapis.com for US, https://www.zohoapis.eu for EU). Generally, users do not need to modify this unless using a specific regional data center.
• LastName: The new last name of the contact (optional). Example: Smith
• FirstName: The new first name of the contact (optional). Example: John
• Email: The new email address of the contact (optional). Format: user@domain.com. Example: john.smith@company.com
• Phone: The new phone number of the contact (optional). Accepts any format. Example: +1-555-123-4567
• AdditionalFields: Additional contact fields as an object (optional). Use Zoho CRM field API names as keys. Refer to Zoho CRM API documentation for field-specific data type requirements. Example: {"Title": "CEO", "Department": "Executive"}

Output:

• UpdatedContact (object): The updated contact object containing:
• id (string): Contact unique identifier
• First_Name (string): First name
• Last_Name (string): Last name
• Email (string): Email address
• Phone (string): Phone number
• Created_Time (string): ISO 8601 datetime
• Modified_Time (string): ISO 8601 datetime
• Owner (object): Owner info with id and name
• OriginalStatusCode (number): The original HTTP status code returned by the upstream Zoho API. Default 0 means the request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): The status code of the operation. 200 for success or business error, 500 for system error.
• ErrorMessage (string): The error message if the operation failed.

Get Custom Module Data

Retrieves records from any Zoho CRM module (standard or custom) with pagination.

Input Parameters:

• ModuleName: The API name of the module to retrieve records from (required). Works with standard modules (Contacts, Leads, Deals, Accounts) and custom modules. Module names are case-sensitive and must match the Zoho CRM module API names exactly. You can obtain available module names through the Get Modules action.

Options:

• ZohoUrl: Zoho CRM API base URL. Default: https://www.zohoapis.com (US). For EU use https://www.zohoapis.eu, for China https://www.zohoapis.com.cn, for India https://www.zohoapis.in.
• PerPage: Number of records per page. Range: 1-200. Default: 200.
• Page: Page number for pagination. Starts from 1. Default: 1.
• AdditionalFields: Comma-separated API field names to add to default fields (id, Created_Time, Modified_Time, Owner). Leave empty to use only default fields. Example: field_1,field_2. Note: Use English API names, not UI display labels.

Output:

• Records (object-array): Array of record objects from the specified module. Each record contains default fields (id, Created_Time, Modified_Time, Owner) and additional fields if specified.
• Info (object): Pagination metadata: per_page (records per page), page (current page), count (records in response), more_records (whether more pages available).
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (not found, invalid module, rate limits), or system error info.

Search Custom Module Data

Searches ANY Zoho module (standard/custom) using advanced criteria or keywords.

Input Parameters:

• ModuleName: The API name of the module to search (required). Can be standard modules (Contacts, Leads, Deals, Accounts) or custom module names. Example: Contacts or My_Custom_Module

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• Criteria: ⚠️ Priority 1 - Advanced search expression. MUTUALLY EXCLUSIVE with Email/Phone/Keyword (if provided, others are ignored). Format: (Field:Operator:Value). Operators: equals, starts_with, contains, greater_than, less_than. Combine with 'and'/'or'. Examples: (Last_Name:equals:Zhang) or (Phone:starts_with:138)and(Status:equals:Active). Leave empty to use Email/Phone/Keyword.
• Email: ⚠️ Priority 2 - Search by exact email match. MUTUALLY EXCLUSIVE with Criteria/Phone/Keyword. Only used if Criteria is empty. Example: user@example.com. Leave empty to use Phone or Keyword.
• Phone: ⚠️ Priority 3 - Search by exact phone match. MUTUALLY EXCLUSIVE with Criteria/Email/Keyword. Only used if Criteria and Email are empty. Example: +1-555-123-4567. Leave empty to use Keyword.
• Keyword: ⚠️ Priority 4 - Fuzzy keyword search across multiple fields. MUTUALLY EXCLUSIVE with Criteria/Email/Phone. Only used if all others are empty. Example: Technology. ⚠️ Use only ONE search method at a time.
• PerPage: Number of records per page. Range: 1-200. Default: 200.
• Page: Page number to retrieve (starts from 1). Default: 1.
• AdditionalFields: Additional fields to return (comma-separated). Use Zoho CRM field API names. Example: Id,First_Name,Last_Name,Email,Phone

Output:

• Data (object-array): Array of records matching the search criteria. Each object contains fields from the module as specified by AdditionalFields parameter.
• Info (object): Pagination metadata: count (total records in response), more_records (boolean), page (current page), per_page (records per page).
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 204, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (invalid criteria, rate limits), or system error info.

Create a Deal

Creates a deal in the Zoho CRM sales pipeline.

Input Parameters:

• DealName: The name of the deal (required). Use a descriptive name identifying the opportunity and customer. Example: Acme Corp - Enterprise License
• Amount: The monetary value of the deal (required) in your account's default currency. Example: 50000
• Stage: The sales pipeline stage (required). Select the stage reflecting where this deal is in your sales process.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• AccountId: The ID of the associated account (optional). Links this deal to a company/organization. You can obtain this ID from Get Many Accounts or Search Accounts action. Example: 3652397000000624001
• ClosingDate: The expected closing date (optional). Format: YYYY-MM-DD. Example: 2024-12-31
• AdditionalFields: Additional deal fields as an object (optional). Use Zoho CRM field API names as keys. Refer to Zoho CRM API documentation for field-specific data type requirements. Example: {"Probability": 75, "Next_Step": "Schedule demo"}
• DuplicateCheckFields: Comma-separated field names for duplicate checking (optional). If a matching deal exists, creation will be skipped. Common fields: Deal_Name, Amount. Leave empty to skip checking. Example: Deal_Name or Deal_Name,Amount

Output:

• CreatedDeal (object): The created deal object containing id, Deal_Name, Amount, Stage, Created_Time, Modified_Time, and Owner.
• OriginalStatusCode (number): The raw HTTP status code returned by the Zoho CRM API (e.g., 200 for success, 429 for rate limited, 400 for bad request).
• StatusCode (number): Operation result code: 200 (success or business error, check ErrorMessage), -1 (parameter validation error), 500 (system/network error).
• ErrorMessage (string): Detailed error description. Empty string when successful. When rate limited (429), includes retry wait time.

Create or Update a Deal

Creates or updates a deal (opportunity) in Zoho CRM using upsert.

Input Parameters:

• DealName: The name of the deal (required). Use a descriptive name identifying the opportunity and customer. Example: Acme Corp - Enterprise License
• Amount: The monetary value of the deal (required) in your account's default currency. Example: 50000
• Stage: The sales pipeline stage (required). Select the stage reflecting where this deal is in your sales process.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• AccountId: The ID of the associated account (optional). Links this deal to a company/organization. You can obtain this ID from Get Many Accounts or Search Accounts action. Example: 3652397000000624001
• ClosingDate: The expected closing date (optional). Format: YYYY-MM-DD. Example: 2024-12-31
• DealId: The ID of the deal to update (optional). If provided, update this specific deal directly, bypassing duplicate check. You can obtain this ID from Search Deals or Get Many Deals action. Example: 3652397000000624001
• AdditionalFields: Additional deal fields as an object (optional). Use Zoho CRM field API names as keys. Refer to Zoho CRM API documentation for field-specific data type requirements. Example: {"Probability": 75, "Next_Step": "Schedule demo"}
• DuplicateCheckFields: Comma-separated field names for duplicate checking (optional). If a matching deal exists, will update instead of creating. Common fields: Deal_Name, Amount. Leave empty to skip checking. Example: Deal_Name or Deal_Name,Amount

Output:

• CreatedOrUpdatedDeal (object): The created or updated deal object containing id, Deal_Name, Amount, Stage, Created_Time, Modified_Time, and Owner.
• OriginalStatusCode (number): The raw HTTP status code returned by the Zoho CRM API (e.g., 200 for success, 429 for rate limited, 400 for bad request).
• StatusCode (number): Operation result code: 200 (success or business error, check ErrorMessage), -1 (parameter validation error), 500 (system/network error).
• ErrorMessage (string): Detailed error description. Empty string when successful. When rate limited (429), includes retry wait time.

Delete a Deal

Permanently deletes a Deal from Zoho CRM.

Input Parameters:

• DealId: The ID of the deal to delete (required). You can obtain this ID from Search Deals or Get Many Deals action. Example: 3652397000000624001

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).

Output:

• DeletedDeal (object): Deletion result object containing id (deleted deal's ID) and status (fixed value: deleted).
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (not found, validation, rate limits), or system error info.

Get a Deal

Retrieves a Deal from Zoho CRM by ID.

Input Parameters:

• DealId: The ID of the deal to retrieve (required). You can obtain this ID from Search Deals or Get Many Deals action. Example: 3652397000000624001

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• AdditionalFields: Comma-separated field names to include beyond default fields. Use Zoho CRM field API names. Example: Custom_Field_1,Department

Output:

• Deal (object): The deal object containing id, Deal_Name, Amount, Stage, Probability, Closing_Date, Account_Name, Contact_Name, Owner, Created_Time, Modified_Time, and any AdditionalFields requested.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (not found, validation, rate limits), or system error info.

Get Many Deals

Retrieves multiple deals from Zoho CRM with pagination support.

Options:

• ZohoUrl: Zoho CRM API base URL. Usually requires no change; use the default value. Only modify if your account is in a different region (e.g., .eu, .com.cn, .in).
• PerPage: Number of records per page (1-200). Default: 200
• Page: Page number for pagination (starts at 1). Default: 1
• AdditionalFields: Comma-separated field names to include beyond defaults. Use Zoho CRM field API names (e.g., Custom_Field_1, Department). Tip: Use 'Get Deal Fields' action to find available API names. Leave empty for default fields.

Output:

• Deals (object-array): Array of deal objects. Each deal contains: id (string), Deal_Name (string), Amount (number), Stage (string), Probability (number), Closing_Date (string: YYYY-MM-DD), Account_Name (object: {id, name}), Contact_Name (object: {id, name}), Owner (object: {id, name}), Created_Time (string: ISO 8601), Modified_Time (string: ISO 8601). Includes AdditionalFields if requested.
• Info (object): Pagination metadata: count (number): records in current page; more_records (boolean): if more pages exist; page (number): current page index; per_page (number): records per page.
• OriginalStatusCode (number): The original HTTP status code returned by Zoho CRM API (e.g., 429, 500, 503). 0 if the request didn't reach the server.
• StatusCode (number): The system status code. 200 for successful API communication (even if business error occurs), 500 for system/network errors.
• ErrorMessage (string): Detailed error message from Zoho or the system.

Search Deals

Searches deals in Zoho CRM using advanced criteria or keywords.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• Criteria: ⚠️ Priority 1 - Advanced search expression. MUTUALLY EXCLUSIVE with Keyword (if provided, Keyword is ignored). Format: (Field:Operator:Value). Operators: equals, contains, starts_with, ends_with, greater_than, less_than. Combine with 'and'/'or'. Examples: (Deal_Name:contains:Project) or (Deal_Name:contains:Project)and(Stage:equals:Closed Won). Leave empty to use Keyword.
• Keyword: ⚠️ Priority 2 - Fuzzy keyword search across multiple fields. MUTUALLY EXCLUSIVE with Criteria. Only used if Criteria is empty. Example: My Deal. ⚠️ Use only ONE search method at a time.
• PerPage: Records per page (1-200). Default: 200
• Page: Page number (starts at 1). Default: 1
• AdditionalFields: Comma-separated field names to include beyond default fields. Use Zoho CRM field API names. Example: Custom_Field_1,Probability

Output:

• Deals (object-array): Array of deal objects matching search criteria. Each contains id, Deal_Name, Amount, Stage, Probability, Closing_Date, Account_Name, Owner, Created_Time, Modified_Time, and any AdditionalFields requested.
• Info (object): Pagination metadata containing count (records in this page), more_records (boolean), page (current page), per_page (records per page).
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 204, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (invalid criteria, rate limits), or system error info.

Update a Deal

Updates an existing Deal in Zoho CRM.

Input Parameters:

• DealId: The ID of the deal to update (required). You can obtain this ID from Search Deals or Get Many Deals action. Example: 3652397000000624001

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• DealName: The new name of the deal (optional). Example: Updated Deal Name
• Amount: The new amount of the deal (optional). Example: 75000
• Stage: The new stage of the deal (optional). Stages: Qualification, Needs Analysis, Value Proposition, Id. Decision Makers, Proposal/Price Quote, Negotiation/Review, Closed Won, Closed Lost.
• AccountId: The new associated account ID (optional). You can obtain this ID from Search Accounts or Get Many Accounts action. Example: 3652397000000624001
• AdditionalFields: Additional deal fields as an object (optional). Use Zoho CRM field API names as keys. Example: {"Probability": 75, "Next_Step": "Send contract"}

Output:

• UpdatedDeal (object): The updated deal object containing id, Created_Time, Modified_Time.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (invalid ID, validation failures, rate limits), or system error info.

Create an Invoice

Creates an invoice in Zoho CRM for billing customers.

Input Parameters:

• Subject: Invoice subject/title (required). A descriptive name identifying the invoice purpose. Example: Q1 2026 Software License
• ProductId: Product ID to invoice (required). Obtain via Get Many Products or Search Products. Example: 5725767000000323001

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• Status: Invoice status (optional). Determines the lifecycle stage. Options: Created, Approved, Delivered, Cancelled
• AccountId: Associated Account ID (optional). Obtain via Get Many Accounts or Search Accounts. Example: 5725767000000524001
• ContactId: Associated Contact ID (optional). Obtain via Get Many Contacts or Search Contacts. Example: 5725767000000515003
• InvoiceDate: Invoice issue date (optional). Format: YYYY-MM-DD. Example: 2026-01-16
• DueDate: Payment due date (optional). Format: YYYY-MM-DD. Example: 2026-02-16
• Quantity: Product quantity (optional). Must be positive. Default: 1. Example: 5
• ListPrice: Unit price of the product (optional). Default: 0. Example: 99.99
• Description: Additional notes for the invoice (optional). Appears on the invoice document. Example: Payment due within 30 days
• AdditionalFields: Additional invoice fields as an object (optional). Use Zoho CRM field API names as keys. To add multiple products, use: {"Invoiced_Items": [{"Product_Name": {"id": "xxx"}, "quantity": 2, "list_price": 100}]}
• DuplicateCheckFields: Fields for duplicate checking (optional, string type, default empty). Comma-separated field API names. If matching record exists, returns error. Example: Subject,Account_Name

Output:

• CreatedInvoice (object): The created invoice object.
• OriginalStatusCode (number): The raw HTTP status code returned by the Zoho CRM API (e.g., 200 for success, 429 for rate limited, 400 for bad request).
• StatusCode (number): Operation result code: 200 (success or business error, check ErrorMessage), -1 (parameter validation error), 500 (system/network error).
• ErrorMessage (string): Detailed error description. Empty string when successful. When rate limited (429), includes retry wait time.

Create or Update an Invoice

Creates or updates an Invoice in Zoho CRM using upsert.

Input Parameters:

• Subject: Invoice subject/title (required). Used for duplicate checking in upsert operation.
• ProductId: Product ID to invoice (required). Obtain via Get Many Products or Search Products. Example: 5725767000000323001

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• Status: Invoice status (optional). Options: Created, Approved, Delivered, Cancelled
• AccountId: Associated Account ID (optional). Obtain via Get Many Accounts or Search Accounts. Example: 5725767000000524001
• ContactId: Associated Contact ID (optional). Obtain via Get Many Contacts or Search Contacts. Example: 5725767000000515003
• InvoiceDate: Invoice issue date (optional). Format: YYYY-MM-DD. Example: 2026-01-16
• DueDate: Payment due date (optional). Format: YYYY-MM-DD. Example: 2026-02-16
• Quantity: Product quantity (optional). Must be positive. Default: 1. Example: 5
• ListPrice: Unit price of the product (optional). Default: 0. Example: 99.99
• Description: Additional notes for the invoice (optional). Example: Payment due within 30 days
• AdditionalFields: Additional invoice fields as an object (optional). Use Zoho CRM field API names as keys. To add multiple products, use: {"Invoiced_Items": [{"Product_Name": {"id": "xxx"}, "quantity": 2, "list_price": 100}]}
• DuplicateCheckFields: Fields for duplicate checking (optional, string type, default empty). Comma-separated field API names. If matching record exists, updates it instead of creating. Example: Subject,Account_Name

Output:

• CreatedOrUpdatedInvoice (object): The created or updated invoice object containing id, Subject, Status, Account_Name, Contact_Name, Invoice_Date, Due_Date, Grand_Total, Created_Time, Modified_Time, and Owner.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (duplicates, validation, rate limits), or system error info.

Delete an Invoice

Permanently deletes an Invoice from Zoho CRM.

Input Parameters:

• InvoiceId: The ID of the invoice to delete (required). You can obtain this ID from Search Invoices or Get Many Invoices action. Example: 5725767000000649013

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).

Output:

• DeletedInvoice (object): The deleted invoice object containing id and status ("deleted").
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (not found, validation, rate limits), or system error info.

Get an Invoice

Retrieves an Invoice from Zoho CRM by ID.

Input Parameters:

• InvoiceId: The ID of the invoice to retrieve (required). You can obtain this ID from Search Invoices or Get Many Invoices action. Example: 5725767000000649013

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• AdditionalFields: Additional fields to return (comma-separated). Use Zoho CRM field API names. Example: Custom_Field_1,Custom_Field_2

Output:

• Invoice (object): The invoice object containing Id, Subject, Status, Account_Name, Contact_Name, Grand_Total, Sub_Total, Tax, Invoice_Date, Due_Date, and other specified fields.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (not found, validation, rate limits), or system error info.

Get Many Invoices

Retrieves a list of invoices from Zoho CRM with pagination and filtering.

Options:

• ZohoUrl: ⚠️ Generally no need to modify, use default. API base URL for your Zoho CRM region. Options: https://www.zohoapis.com (US), https://www.zohoapis.eu (EU), https://www.zohoapis.com.cn (China), https://www.zohoapis.in (India), https://www.zohoapis.com.au (Australia).
• PerPage: Number of records per page. Range: 1-200. Default: 200.
• Page: Page number to retrieve (starts from 1). Default: 1.
• AdditionalFields: Comma-separated list of additional field API names to retrieve (no spaces). Use Zoho CRM field API names. If unsure, use 'Get Invoice Fields' to query available fields. Common fields: Discount, Adjustment, Terms_and_Conditions, Description, Billing_Street, Shipping_Street. Example: Discount,Adjustment,Terms_and_Conditions

Output:

• Invoices (object-array): List of invoices. Key fields: Id (string), Subject (string), Status (string: Draft, Sent, Paid, Overdue, Void), Grand_Total (number), Sub_Total (number), Account_Name (object: id, name), Invoice_Date (string).
• Info (object): Pagination metadata. Fields: count (number), more_records (boolean), page (number), per_page (number).
• OriginalStatusCode (number): Zoho API returned original HTTP status code.
• StatusCode (number): System operation status code. 200 = system healthy (including API business errors), 500 = system error, -1 = parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful.

Search Invoices

Searches invoices in Zoho CRM using advanced criteria or keywords.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• Criteria: ⚠️ Priority 1 - Advanced search expression. MUTUALLY EXCLUSIVE with Keyword (if provided, Keyword is ignored). Format: (Field:Operator:Value). Operators: equals, starts_with, contains, greater_than, less_than. Combine with 'and'/'or'. Examples: (Subject:starts_with:INV) or (Status:equals:Paid)and(Grand_Total:greater_than:5000). Leave empty to use Keyword.
• Keyword: ⚠️ Priority 2 - Fuzzy keyword search across multiple fields. MUTUALLY EXCLUSIVE with Criteria. Only used if Criteria is empty. Example: INV-2024-001. ⚠️ Use only ONE search method at a time.
• PerPage: Number of records per page. Range: 1-200. Default: 200.
• Page: Page number to retrieve (starts from 1). Default: 1.
• AdditionalFields: Additional fields to return (comma-separated). Use Zoho CRM field API names. Example: Custom_Field_1,Custom_Field_2

Output:

• Invoices (object-array): Array of invoices matching the search criteria. Each object contains Id, Subject, Status, Account_Name, Contact_Name, Grand_Total, and other fields.
• Info (object): Pagination metadata: count (total records in response), more_records (boolean), page (current page), per_page (records per page).
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 204, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (invalid criteria, rate limits), or system error info.

Update an Invoice

Updates an existing Invoice in Zoho CRM.

Input Parameters:

• InvoiceId: The ID of the invoice to update (required). Obtain via Search Invoices or Get Many Invoices. Example: 5725767000000649013

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• Subject: New invoice subject/title (optional). Example: Q1 2026 Software License
• Status: New invoice status (optional). Options: Created, Approved, Delivered, Cancelled
• AccountId: New associated Account ID (optional). Obtain via Get Many Accounts or Search Accounts. Example: 5725767000000524001
• ContactId: New associated Contact ID (optional). Obtain via Get Many Contacts or Search Contacts. Example: 5725767000000515003
• InvoiceDate: New invoice date (optional). Format: YYYY-MM-DD. Example: 2026-01-16
• DueDate: New payment due date (optional). Format: YYYY-MM-DD. Example: 2026-02-16
• ProductId: Product ID for line item (optional). Obtain via Get Many Products or Search Products. Example: 5725767000000323001
• Quantity: Product quantity (optional). Must be positive. Default: 1. Example: 5
• ListPrice: Unit price of the product (optional). Default: 0. Example: 99.99
• Description: Additional notes for the invoice (optional). Example: Payment due within 30 days
• AdditionalFields: Additional invoice fields as an object (optional). Use Zoho CRM field API names as keys. Example: {"Tax": 50, "Discount": 100}

Output:

• UpdatedInvoice (object): The updated invoice object containing id, Created_Time, Modified_Time.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (invalid ID, validation failures, rate limits), or system error info.

Create a Lead

Creates a lead in Zoho CRM.

Input Parameters:

• LastName: The last name (family name) of the lead (required). This is the only required field for creating a lead in Zoho CRM. Example: 'Smith', 'Zhang'.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region:
• EU region: https://www.zohoapis.eu
• China region: https://www.zohoapis.com.cn
• India region: https://www.zohoapis.in
• Australia region: https://www.zohoapis.com.au
• FirstName: The first name (given name) of the lead (optional). Example: 'John', 'Wei'.
• Company: The company or organization name of the lead (optional). For B2B sales, this is typically the prospect's employer. Example: 'Acme Corporation', 'Tech Startup Inc.'.
• Email: The email address of the lead (optional). Format: user@domain.com. This field is commonly used for duplicate checking and email campaigns. Example: 'john.smith@company.com'.
• Phone: The phone number of the lead (optional). Accepts any format. Example: '+1-555-123-4567', '13800138000'.
• LeadSource: The source/origin of this lead (optional). Indicates how the lead was acquired.

Common Zoho CRM Lead Source values:

• Advertisement
• Cold Call
• Employee Referral
• External Referral
• Online Store
• Partner
• Public Relations
• Sales Email Alias
• Seminar Partner
• Internal Seminar
• Trade Show
• Web Download
• Web Research
• Chat
• Twitter
• Facebook

Note: Your Zoho CRM may have custom Lead Source values configured by your administrator.

• AdditionalFields: Additional lead fields as an object (optional). Use Zoho CRM field API names as keys. Refer to Zoho CRM API documentation for field-specific data type requirements. Example: {"Title": "CTO", "Industry": "Technology", "Rating": "Hot"}
• DuplicateCheckFields: Comma-separated list of field API names to check for duplicates before creating (optional). If a lead with matching values already exists, the API returns an error instead of creating a duplicate.

Common fields for duplicate check: Email, Phone, Mobile

Example: 'Email' or 'Email,Phone'

Note: Leave empty to skip duplicate checking. Recommended to use 'Email' for most cases to prevent duplicate leads on retry.

Output:

• CreatedLead (object): The created lead object containing id, First_Name, Last_Name, Company, Email, Phone, Created_Time, Modified_Time, Created_By, and Owner.
• OriginalStatusCode (number): The raw HTTP status code returned by the Zoho CRM API (e.g., 200 for success, 429 for rate limited, 400 for bad request).
• StatusCode (number): Operation result code: 200 (success or business error, check ErrorMessage), -1 (parameter validation error), 500 (system/network error).
• ErrorMessage (string): Detailed error description. Empty string when successful.

Create or Update a Lead

Creates or updates a lead (potential customer) in Zoho CRM using upsert.

Input Parameters:

• LastName: The last name (family name) of the lead (required). This is the only required field for creating or updating a lead in Zoho CRM. Example: 'Smith', 'Zhang'.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region:
• EU region: https://www.zohoapis.eu
• China region: https://www.zohoapis.com.cn
• India region: https://www.zohoapis.in
• Australia region: https://www.zohoapis.com.au
• FirstName: The first name (given name) of the lead (optional). Example: 'John', 'Wei'.
• Company: The company or organization name of the lead (optional). For B2B sales, this is typically the prospect's employer. Example: 'Acme Corporation', 'Tech Startup Inc.'.
• Email: The email address of the lead (optional). Format: user@domain.com. This field is commonly used for duplicate checking and email campaigns. If a lead with the same email exists, it will be updated instead of creating a duplicate. Example: 'john.smith@company.com'.
• Phone: The phone number of the lead (optional). Accepts any format. Example: '+1-555-123-4567', '13800138000'.
• LeadSource: The source/origin of this lead (optional). Indicates how the lead was acquired.

Common Zoho CRM Lead Source values:

• Advertisement
• Cold Call
• Employee Referral
• External Referral
• Online Store
• Partner
• Public Relations
• Sales Email Alias
• Seminar Partner
• Internal Seminar
• Trade Show
• Web Download
• Web Research
• Chat
• Twitter
• Facebook

Note: Your Zoho CRM may have custom Lead Source values configured by your administrator.

• LeadId: The ID of the lead to update (optional). If provided, updates this specific lead directly, bypassing duplicate check. How to get this ID: Use 'Search Leads' or 'Get Many Leads' action to retrieve Lead IDs. Example: 3652397000000624001
• AdditionalFields: Additional lead fields as an object (optional). Use Zoho CRM field API names as keys. Common fields: Title (string), Industry (string), Annual_Revenue (number), No_of_Employees (number), Website (string), Mobile (string), Street/City/State/Zip_Code/Country, Description (string), Lead_Status (string), Rating (string). Example: {"Title": "CTO", "Industry": "Technology", "Rating": "Hot", "Website": "https://example.com"}
• DuplicateCheckFields: Comma-separated list of field API names to check for duplicates before creating (optional). If a lead with matching values already exists, it will be updated instead of creating a duplicate (upsert behavior).

Common fields for duplicate check: Email, Phone, Mobile

Example: 'Email' or 'Email,Phone'

Note: Leave empty to skip duplicate checking (will use Email by default for upsert). This parameter only applies when LeadId is NOT provided.

Output:

• CreatedOrUpdatedLead (object): The created or updated lead object containing:
• id (string): Unique identifier of the lead in Zoho CRM
• Created_Time (string): Creation timestamp in ISO 8601 format
• Modified_Time (string): Last modification timestamp
• Created_By (object): User who created the record, contains 'id' and 'name'
• Owner (object): Lead owner, contains 'id' and 'name'
• OriginalStatusCode (number): The raw HTTP status code returned by the Zoho CRM API (e.g., 200 for success, 429 for rate limited, 400 for bad request).
• StatusCode (number): Operation result code: 200 (success or business error, check ErrorMessage), -1 (parameter validation error), 500 (system/network error).
• ErrorMessage (string): Detailed error description. Empty string when successful. Contains upstream API error details for debugging.

Delete a Lead

Permanently deletes a Lead from Zoho CRM.

Input Parameters:

• LeadId: The unique ID of the lead to delete (required). Obtain from Search Leads or Get Many Leads workflow. Format: Zoho-generated numeric string. Example: '4150868000001234567'

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).

Output:

• DeletedLead (object): Deleted lead object containing: id (string: deleted lead ID), status (string: always 'deleted')
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (not found, validation, rate limits), or system error info.

Get a Lead

Retrieves a Lead from Zoho CRM by ID.

Input Parameters:

• LeadId: The ID of the lead to retrieve.

Options:

• ZohoUrl: The base URL of the Zoho CRM instance (e.g., https://www.zohoapis.com).
• Fields: Comma-separated list of field API names to retrieve (optional). Leave empty to retrieve all default fields. Example: Last_Name,Email,Phone

Output:

• Lead (object): The lead object containing id, Last_Name, First_Name, Email, Phone, Company, Lead_Source, Created_Time, Modified_Time, Created_By, and Owner.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (not found, validation, rate limits), or system error info.

Get Lead Fields

Retrieves field definitions for the Leads module from Zoho CRM.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).

Output:

• Fields (object-array): Array of field objects. Each contains api_name (API field name), display_label (UI display name), data_type (field type), and required (boolean).
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (no fields, rate limits), or system error info.

Get Many Leads

Retrieves a list of leads from Zoho CRM with pagination.

Options:

• ZohoUrl: The API root URL for your Zoho region. Default is https://www.zohoapis.com (US). Other regions: EU (https://www.zohoapis.eu), India (https://www.zohoapis.in), Australia (https://www.zohoapis.com.au), China (https://www.zohoapis.com.cn). Most users can leave this as default.
• PerPage: Number of leads to retrieve per page. Valid range: 1-200. Default is 200 for maximum efficiency.
• Page: Page number to retrieve (1-based). Use with PerPage for pagination. Check Info.more_records in response to determine if more pages exist.
• AdditionalFields: Comma-separated list of additional API field names to retrieve. Use "" to retrieve all fields. WARNING: Using "" significantly increases response time and token usage. Example: "Website,Rating,Description"

Output:

• Leads (object-array): List of lead objects containing lead details like Id, Email, Company, etc.
• Info (object): Pagination metadata. Contains: per_page (number): records per page; page (number): current page index; count (number): records in current response; more_records (boolean): whether more pages exist.
• OriginalStatusCode (number): The original HTTP status code returned by the Zoho API. Default 0 if request failed before reaching server. Use for debugging.
• StatusCode (number): Operation status code: 200=Success (check ErrorMessage for business errors), 500=System error.
• ErrorMessage (string): Detailed error message. Empty string if successful.

Search Leads

Searches leads in Zoho CRM using advanced criteria, email, phone, or keyword.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• Criteria: ⚠️ Priority 1 - Advanced search expression. MUTUALLY EXCLUSIVE with Email/Phone/Keyword (if provided, others are ignored). Format: (Field:Operator:Value). Operators: equals, starts_with, contains, greater_than, less_than. Combine with 'and'/'or'. Examples: (Last_Name:equals:Zhang) or (Last_Name:equals:Zhang)and(Lead_Status:equals:Hot). Leave empty to use Email/Phone/Keyword.
• Email: ⚠️ Priority 2 - Search by exact email match. MUTUALLY EXCLUSIVE with Criteria/Phone/Keyword. Only used if Criteria is empty. Example: zhang@example.com. Leave empty to use Phone or Keyword.
• Phone: ⚠️ Priority 3 - Search by exact phone match. MUTUALLY EXCLUSIVE with Criteria/Email/Keyword. Only used if Criteria and Email are empty. Example: +1-555-123-4567. Leave empty to use Keyword.
• Keyword: ⚠️ Priority 4 - Fuzzy keyword search across multiple fields. MUTUALLY EXCLUSIVE with Criteria/Email/Phone. Only used if all others are empty. Example: Technology. ⚠️ Use only ONE search method at a time.
• PerPage: Number of records per page. Range: 1-200. Default: 200.
• Page: Page number for pagination. Starts from 1. Default: 1.
• AdditionalFields: Comma-separated list of additional field API names to include in results (optional). Example: Custom_Field_1,Custom_Field_2

Output:

• Leads (object-array): Array of lead objects matching search criteria. Each object contains id, Last_Name, First_Name, Email, Phone, Mobile, Company, Lead_Source, Lead_Status, Owner, Created_Time, Modified_Time, and any additional fields requested.
• Info (object): Pagination metadata object with count (total records in response), more_records (boolean), per_page, and page.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 204, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (invalid criteria, rate limits), or system error info.

Update a Lead

Updates an existing Lead in Zoho CRM using idempotent upsert.

Input Parameters:

• LeadId: The unique ID of the lead to update (required). Obtain from: (1) Search Leads action with email/keywords, (2) Get Many Leads action, or (3) Create a Lead response (CreatedLead.id). Example: '3652397000000624001'

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most US-region tenants. Only change if your org uses another data center:
• EU region: https://www.zohoapis.eu
• India region: https://www.zohoapis.in
• Australia region: https://www.zohoapis.com.au
• China region: https://www.zohoapis.com.cn

If uncertain, contact your Zoho admin.

• LastName: Updated last name/family name (optional). Supports up to 255 characters. Example: 'Smith'
• Company: Updated company/organization name (optional). For B2B records, use employer name. Example: 'Acme Corporation'
• Email: Updated email address (optional). Format: user@example.com. Used for duplicate detection and communications.
• LeadSource: Updated lead source (optional). Common values: Advertisement, Cold Call, Employee Referral, External Referral, Online Store, Partner, Public Relations, Seminar, Trade Show, Web Download, Web Research, Chat. Your org may have custom sources.
• AdditionalFields: Additional lead fields as an object (optional). Use Zoho CRM field API names as keys. Common fields: First_Name (string), Phone (string), Mobile (string), Title (string), Industry (string), Lead_Status (string), Website (string), Description (string), Owner (object: {"id": "owner_id"}). Example: {"First_Name": "John", "Phone": "+1-555-123-4567", "Lead_Status": "Qualified"}

Output:

• UpdatedLead (object): Updated lead object containing: id (string: lead unique ID), Created_Time (string: ISO 8601), Modified_Time (string: ISO 8601).
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (invalid ID, validation failures, rate limits), or system error info.

Get Module Fields

Retrieves all field metadata for a specified Zoho CRM module.

Input Parameters:

• ModuleName: The API name of the module to retrieve fields for (required). Standard modules: Contacts, Leads, Deals, Accounts, etc. You can obtain available module names through the Get Modules action.

Options:

• ZohoUrl: Zoho CRM API base URL. Default: https://www.zohoapis.com (US). For EU use https://www.zohoapis.eu, for China https://www.zohoapis.com.cn, for India https://www.zohoapis.in.

Output:

• Fields (object-array): Array of field objects for the module. Each field contains: api_name (API identifier), field_label (display name), data_type (field data type), custom_field (boolean), system_mandatory (boolean), visible (boolean), read_only (boolean).
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (no fields, invalid module, rate limits), or system error info.

Get Modules

Retrieves all available modules from Zoho CRM.

Options:

• ZohoUrl: Zoho CRM API base URL. Default: https://www.zohoapis.com (US). For EU use https://www.zohoapis.eu, for China https://www.zohoapis.com.cn, for India https://www.zohoapis.in.

Output:

• Modules (object-array): Array of module objects available in Zoho CRM. Each module contains: api_name (API identifier like 'Leads', 'Contacts'), module_name (display name), generated_type (module type), id (unique identifier).
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (no modules, rate limits), or system error info.

Create a Product

Creates a product in the Zoho CRM catalog.

Input Parameters:

• ProductName: The name of the product (required). Example: Enterprise Software License.
• UnitPrice: The unit price of the product in your account default currency (optional). Example: 99.99
• ProductActive: Whether the product is active and available for sale (optional). true = active, false = inactive.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• ProductCode: The product code or SKU for inventory tracking (optional). Example: SKU-12345.
• Description: Detailed description of the product (optional).
• Manufacturer: The manufacturer or brand name of the product (optional). Example: Apple, Samsung.
• AdditionalFields: Additional product fields as JSON object (optional). Use Zoho CRM field API names as keys. Note: Different fields have different data types in Zoho CRM. Refer to Zoho CRM API documentation for field-specific data type requirements. Example: {\"Qty_in_Stock\": 100, \"Manufacturer\": \"Tech Corp\"}
• DuplicateCheckFields: Comma-separated field names for duplicate check (optional). If left empty, uses default duplicate checking.

Example: 'Product_Code' or 'Product_Code,Manufacturer'

Output:

• CreatedProduct (object): The created product object containing id, Product_Name, Product_Code, Unit_Price, Created_Time, Owner.
• OriginalStatusCode (number): The raw HTTP status code returned by the Zoho CRM API (e.g., 200 for success, 429 for rate limited, 400 for bad request).
• StatusCode (number): Operation result code: 200 (success or business error, check ErrorMessage), -1 (parameter validation error), 500 (system/network error).
• ErrorMessage (string): Detailed error description. Empty string when successful. When rate limited (429), includes retry wait time.

Create or Update a Product

Creates or updates a product in Zoho CRM using upsert.

Input Parameters:

• ProductName: The name of the product (required). Example: Enterprise Software License.
• UnitPrice: The unit price of the product in your account default currency (optional). Example: 99.99
• ProductActive: Whether the product is active and available for sale (optional). true = active, false = inactive.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• ProductCode: The product code or SKU for inventory tracking (optional). Example: SKU-12345.
• Description: Detailed description of the product (optional).
• Manufacturer: The manufacturer or brand name of the product (optional). Example: Apple, Samsung.
• ProductId: The ID of an existing product to update (optional). If provided, updates the existing product directly. How to get this ID: Use 'Search Products' or 'Get Many Products' action.
• AdditionalFields: Additional product fields as JSON object (optional). Use Zoho CRM field API names as keys. Note: Different fields have different data types in Zoho CRM. Refer to Zoho CRM API documentation for field-specific data type requirements. Example: {"Qty_in_Stock": 100, "Manufacturer": "Tech Corp"}
• DuplicateCheckFields: Comma-separated field names for duplicate check (optional). If left empty, uses default duplicate checking. Example: 'Product_Code' or 'Product_Code,Manufacturer'

Output:

• CreatedOrUpdatedProduct (object): The created or updated product object containing id, Product_Name, Product_Code, Unit_Price, Created_Time, Owner.
• OriginalStatusCode (number): The raw HTTP status code returned by the Zoho CRM API (e.g., 200 for success, 429 for rate limited, 400 for bad request).
• StatusCode (number): Operation result code: 200 (success or business error, check ErrorMessage), -1 (parameter validation error), 500 (system/network error).
• ErrorMessage (string): Detailed error description. Empty string when successful. When rate limited (429), includes retry wait time.

Delete a Product

Permanently deletes a Product from Zoho CRM.

Input Parameters:

• ProductId: The unique ID of the product to delete (required). You can obtain this ID through: Search Products or Get Many Products action, or from the response of Create Product action.

Options:

• ZohoUrl: Zoho CRM API base URL. Default: https://www.zohoapis.com (US). For EU use https://www.zohoapis.eu, for China https://www.zohoapis.com.cn, for India https://www.zohoapis.in.

Output:

• DeletedProduct (object): The deleted product object containing: id (deleted product ID) and status (always 'deleted' on success).
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (not found, validation, rate limits), or system error info.

Get a Product

Retrieves a Product from Zoho CRM by ID.

Input Parameters:

• ProductId: The unique ID of the product to retrieve (required). You can obtain this ID through: Search Products or Get Many Products action, or from the response of Create Product action.

Options:

• ZohoUrl: Zoho CRM API base URL. Default: https://www.zohoapis.com (US). For EU use https://www.zohoapis.eu, for China https://www.zohoapis.com.cn, for India https://www.zohoapis.in.
• Fields: Comma-separated field names to include in results. Leave empty to retrieve all fields. Example: Product_Name,Unit_Price,Qty_in_Stock

Output:

• Product (object): The product object containing: id, Product_Name, Product_Code, Product_Active, Manufacturer, Unit_Price, Qty_in_Stock, Tax, Owner, Created_Time, Modified_Time, and additional fields if specified.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (not found, validation, rate limits), or system error info.

Get Many Products

Retrieves Products from Zoho CRM with pagination.

Options:

• ZohoUrl: Zoho CRM API base URL. Default: https://www.zohoapis.com (US). For EU use https://www.zohoapis.eu, for China https://www.zohoapis.com.cn, for India https://www.zohoapis.in.
• PerPage: Number of records per page. Range: 1-200. Default: 200.
• Page: Page number for pagination. Starts from 1. Default: 1.
• AdditionalFields: Comma-separated field names to include in results. Only use for custom fields not in default set. Example: Custom_Field_1,Custom_Field_2

Output:

• Products (object-array): Array of product objects with fields: Id, Product_Name, Product_Code, Product_Active, Manufacturer, Unit_Price, Qty_in_Stock, Tax, Owner, Created_Time, Modified_Time, and additional fields if specified.
• Info (object): Pagination metadata: per_page (records per page), page (current page), count (records in response), more_records (whether more pages available).
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (no products, rate limits), or system error info.

Search Products

Searches products in Zoho CRM using advanced criteria or keywords.

Options:

• ZohoUrl: Zoho CRM API base URL. Default: https://www.zohoapis.com (US). For EU use https://www.zohoapis.eu, for China https://www.zohoapis.com.cn, for India https://www.zohoapis.in.
• Criteria: ⚠️ Priority 1 - Advanced search expression. MUTUALLY EXCLUSIVE with Keyword (if provided, Keyword is ignored). Format: (Field:Operator:Value). Operators: equals, starts_with, contains, greater_than, less_than. Combine with 'and'/'or'. Examples: (Product_Name:starts_with:iPhone) or (Product_Active:equals:true)and(Unit_Price:greater_than:100). Leave empty to use Keyword.
• Keyword: ⚠️ Priority 2 - Fuzzy keyword search across multiple fields. MUTUALLY EXCLUSIVE with Criteria. Only used if Criteria is empty. Example: Enterprise. ⚠️ Use only ONE search method at a time.
• PerPage: Number of records per page. Range: 1-200. Default: 200.
• Page: Page number for pagination. Starts from 1. Default: 1.
• AdditionalFields: Comma-separated field names to include in results. Only use for custom fields not in default set. Example: Custom_Field_1,Custom_Field_2

Output:

• Products (object-array): Array of product objects matching search criteria. Each contains: Id, Product_Name, Product_Code, Product_Active, Manufacturer, Unit_Price, Qty_in_Stock, Tax, Owner, Created_Time, Modified_Time, and additional fields if specified.
• Info (object): Pagination metadata: count (records in response), more_records (whether more available), per_page (records per page), page (current page number).
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 204, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (invalid criteria, rate limits), or system error info.

Update a Product

Updates an existing Product in Zoho CRM.

Input Parameters:

• ProductId: The ID of the product to update (required). You can obtain this ID from Search Products or Get Many Products action. Example: 5725767000000323001

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• ProductName: The new name of the product (optional). Example: Enterprise Software License v2.0
• ProductCode: The new product code or SKU (optional). Example: SKU-12345-v2
• UnitPrice: The new unit price (optional). Must be positive. Example: 99.99
• Description: The new description of the product (optional). Example: High-quality enterprise software
• Manufacturer: The new manufacturer or brand name (optional). Example: Tech Corp
• AdditionalFields: Additional product fields as an object (optional). Use Zoho CRM field API names as keys. Example: {"Qty_in_Stock": 100}

Output:

• UpdatedProduct (object): The updated product object containing id, Created_Time, Modified_Time.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (invalid ID, validation failures, rate limits), or system error info.

Create a Purchase Order

Creates a purchase order in Zoho CRM for vendor ordering.

Input Parameters:

• Subject: The subject/title of the purchase order (required). Example: PO-2024-001 Office Supplies
• ProductId: The ID of the product to order (required). You can obtain this ID from Get Many Products or Search Products action. Example: 3652397000000624001

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• Status: The status of the purchase order (optional). Statuses: Created, Approved, Delivered, Cancelled, Rejected, Received
• VendorId: The ID of the vendor/supplier (optional). You can obtain this ID from Get Many Vendors or Search Vendors action. Example: 3652397000000624001
• ContactId: The ID of the contact person at the vendor (optional). You can obtain this ID from Get Many Contacts action. Example: 3652397000000624001
• DueDate: Expected delivery date (optional). Format: YYYY-MM-DD. Example: 2024-12-31
• Quantity: The quantity of products to order (optional, default 1). Must be a positive number. Example: 10
• ListPrice: The unit price per product in your account's currency (optional, default 0). If 0, uses product's default price. Example: 99.99
• Description: Additional notes or description for this purchase order (optional). Example: Rush order for client A
• AdditionalFields: Additional PO fields as an object (optional). Use Zoho CRM field API names as keys. Refer to Zoho CRM API documentation for field-specific data type requirements. Example: {"Tracking_Number": "TRK123", "Carrier": "FedEx"}
• DuplicateCheckFields: Comma-separated field names for duplicate checking (optional). If a matching PO exists, creation will be skipped. Leave empty to skip checking. Example: Subject

Output:

• CreatedPurchaseOrder (object): The created purchase order object containing id, Subject, Status, Vendor_Name, Grand_Total, Created_Time, Owner.
• OriginalStatusCode (number): The raw HTTP status code returned by the Zoho CRM API (e.g., 200 for success, 429 for rate limited, 400 for bad request).
• StatusCode (number): Operation result code: 200 (success or business error, check ErrorMessage), -1 (parameter validation error), 500 (system/network error).
• ErrorMessage (string): Detailed error description. Empty string when successful. When rate limited (429), includes retry wait time.

Create or Update a Purchase Order

Creates or updates a purchase order (PO) in Zoho CRM using upsert.

Input Parameters:

• Subject: The subject/title of the purchase order (required). Example: PO-2024-001 Office Supplies
• ProductId: The ID of the product to order (required). You can obtain this ID from Get Many Products or Search Products action. Example: 3652397000000624001

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• Status: The status of the purchase order (optional). Statuses: Created, Approved, Delivered, Cancelled, Rejected, Received
• VendorId: The ID of the vendor/supplier (optional). You can obtain this ID from Get Many Vendors or Search Vendors action. Example: 3652397000000624001
• ContactId: The ID of the contact person at the vendor (optional). You can obtain this ID from Get Many Contacts action. Example: 3652397000000624001
• DueDate: Expected delivery date (optional). Format: YYYY-MM-DD. Example: 2024-12-31
• Quantity: The quantity of products to order (optional, default 1). Must be a positive number. Example: 10
• ListPrice: The unit price per product in your account's currency (optional, default 0). If 0, uses product's default price. Example: 99.99
• Description: Additional notes or description for this purchase order (optional). Example: Rush order for client A
• PurchaseOrderId: The ID of an existing PO to update (optional). If provided, directly updates that PO. You can obtain this ID from Search Purchase Orders or Get Many Purchase Orders action. Example: 3652397000000624001
• AdditionalFields: Additional PO fields as an object (optional). Use Zoho CRM field API names as keys. Refer to Zoho CRM API documentation for field-specific data type requirements. Example: {"Tracking_Number": "TRK123", "Carrier": "FedEx"}
• DuplicateCheckFields: Comma-separated field names for duplicate checking (optional). If a matching PO exists, will update instead of creating. Leave empty to skip checking. Example: Subject

Output:

• CreatedOrUpdatedPurchaseOrder (object): The created or updated purchase order object containing id, Created_Time, Modified_Time.
• OriginalStatusCode (number): The raw HTTP status code returned by the Zoho CRM API (e.g., 200 for success, 429 for rate limited, 400 for bad request).
• StatusCode (number): Operation result code: 200 (success or business error, check ErrorMessage), -1 (parameter validation error), 500 (system/network error).
• ErrorMessage (string): Detailed error description. Empty string when successful. When rate limited (429), includes retry wait time.

Delete a Purchase Order

Permanently deletes a Purchase Order from Zoho CRM.

Input Parameters:

• PurchaseOrderId: The ID of the purchase order to delete (required). You can obtain this ID from Search Purchase Orders or Get Many Purchase Orders action. Example: 5725767000000649013

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).

Output:

• DeletedPurchaseOrder (object): The deleted purchase order object containing id and status ("deleted").
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (not found, validation, rate limits), or system error info.

Get a Purchase Order

Retrieves a Purchase Order from Zoho CRM by ID.

Input Parameters:

• PurchaseOrderId: The ID of the purchase order to retrieve (required). You can obtain this ID from Search Purchase Orders or Get Many Purchase Orders action. Example: 5725767000000649013

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• AdditionalFields: Additional fields to return (comma-separated). Use Zoho CRM field API names. Example: Custom_Field_1,Custom_Field_2

Output:

• PurchaseOrder (object): The purchase order object containing Id, Subject, Status, Vendor_Name, Contact_Name, Grand_Total, Sub_Total, and other specified fields.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (not found, validation, rate limits), or system error info.

Get Many Purchase Orders

Retrieves Purchase Orders from Zoho CRM with pagination.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• PerPage: Number of records per page. Range: 1-200. Default: 200.
• Page: Page number to retrieve (starts from 1). Default: 1.
• AdditionalFields: Additional fields to return (comma-separated). Use Zoho CRM field API names. Example: Custom_Field_1,Custom_Field_2

Output:

• PurchaseOrders (object-array): Array of purchase orders. Each object contains Id, Subject, Status, Vendor_Name, Contact_Name, Grand_Total, and other fields specified in AdditionalFields.
• Info (object): Pagination metadata: count (total records in response), more_records (boolean), page (current page), per_page (records per page).
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (no records, rate limits), or system error info.

Search Purchase Orders

Searches purchase orders in Zoho CRM using advanced criteria or keywords.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• Criteria: ⚠️ Priority 1 - Advanced search expression. MUTUALLY EXCLUSIVE with Keyword (if provided, Keyword is ignored). Format: (Field:Operator:Value). Operators: equals, starts_with, contains, greater_than, less_than. Combine with 'and'/'or'. Examples: (Subject:starts_with:PO-) or (Status:equals:Created)and(Grand_Total:greater_than:5000). Leave empty to use Keyword.
• Keyword: ⚠️ Priority 2 - Fuzzy keyword search across multiple fields. MUTUALLY EXCLUSIVE with Criteria. Only used if Criteria is empty. Example: PO-2024-001. ⚠️ Use only ONE search method at a time.
• PerPage: Number of records per page. Range: 1-200. Default: 200.
• Page: Page number to retrieve (starts from 1). Default: 1.
• AdditionalFields: Additional fields to return (comma-separated). Use Zoho CRM field API names. Example: Custom_Field_1,Custom_Field_2

Output:

• PurchaseOrders (object-array): Array of purchase orders matching the search criteria. Each object contains Id, Subject, Status, Vendor_Name, Contact_Name, Grand_Total, and other fields.
• Info (object): Pagination metadata: count (total records in response), more_records (boolean), page (current page), per_page (records per page).
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 204, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (invalid criteria, rate limits), or system error info.

Update a Purchase Order

Updates an existing Purchase Order in Zoho CRM.

Input Parameters:

• PurchaseOrderId: The ID of the purchase order to update (required). You can obtain this ID from Search Purchase Orders or Get Many Purchase Orders action. Example: 5725767000000649013

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• Subject: The new subject/title of the purchase order (optional). Example: Office Supplies Order - Q1 2026
• Status: The new status of the purchase order (optional). Statuses: Created, Approved, Delivered, Cancelled, Rejected, Received
• VendorId: The new associated vendor ID (optional). You can obtain this ID from Get Many Vendors or Search Vendors action. Example: 5725767000000524001
• ContactId: The new associated contact person ID at the vendor (optional). You can obtain this ID from Get Many Contacts action. Example: 5725767000000515003
• DueDate: The new due/delivery date (optional). Format: YYYY-MM-DD. Example: 2026-12-31
• Description: Additional description or notes for this purchase order (optional). Example: Urgent delivery required
• AdditionalFields: Additional PO fields as an object (optional). Use Zoho CRM field API names as keys. Example: {"Carrier": "FedEx", "Tracking_Number": "1234567890"}

Output:

• UpdatedPurchaseOrder (object): The updated purchase order object containing id, Created_Time, Modified_Time.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (invalid ID, validation failures, rate limits), or system error info.

Create a Quote

Creates a quote in Zoho CRM for sales proposals.

Input Parameters:

• Subject: The subject/title of the quote (required). Example: Quote for Enterprise License 2024.
• ProductId: The unique ID of the product for the quote line item (required). Get this ID via Get Many Products or Search Products action.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• QuoteStage: The current stage of the quote in the sales cycle (optional).
• ValidTill: Quote expiration date in YYYY-MM-DD format (optional). Example: 2024-12-31
• AccountId: The unique ID of the associated company/account (optional). Get this ID via Get Many Accounts or Search Accounts action.
• ContactId: The unique ID of the contact person (optional). Get this ID via Get Many Contacts or Search Contacts action.
• Quantity: The quantity of products to quote (optional, default 1). Must be a positive integer.
• ListPrice: The unit price per product in your account default currency (optional). If 0 or not set, uses the product's default price.
• Description: Additional notes or terms for this quote (optional).
• AdditionalFields: Additional quote fields as an object (optional). Use Zoho CRM field API names as keys. Example: {"Deal_Name": {"id": "xxx"}, "Carrier": "FedEx"}
• DuplicateCheckFields: Comma-separated field names for duplicate check (optional). Example: Subject

Output:

• CreatedQuote (object): The created quote object containing id, Subject, Quote_Stage, Valid_Till, Grand_Total, Created_Time, Modified_Time, and Owner.
• OriginalStatusCode (number): The raw HTTP status code returned by the Zoho CRM API (e.g., 200 for success, 429 for rate limited, 400 for bad request).
• StatusCode (number): Operation result code: 200 (success or business error, check ErrorMessage), -1 (parameter validation error), 500 (system/network error).
• ErrorMessage (string): Detailed error description. Empty string when successful.

Create or Update a Quote

Creates or updates a quote in Zoho CRM using upsert.

Input Parameters:

• Subject: The subject/title of the quote (required). NOTE: Subject is used for duplicate checking (upsert). If a Quote with the same Subject exists, it will be updated.
• ProductId: The ID of the product for line item (required). IMPORTANT: This action only supports ONE product per quote. For multiple products, use AdditionalFields. How to get: Use 'Search Products' action.

Options:

• ZohoUrl: The base URL of the Zoho CRM instance. Usually no modification needed, use default value. For EU/CN regions, contact your admin.
• QuoteStage: The stage of the quote (optional). Represents where the quote sits in the sales process: Draft (initial draft, not yet sent to the customer); Negotiation (actively discussing terms and price with the customer); Delivered (quote sent, awaiting customer response); On Hold (paused pending internal or external factors); Confirmed (customer accepted in principle, pending final approval); Closed Won (won deal, customer accepted the quote); Closed Lost (lost deal or customer declined).
• ValidTill: The quote validity/expiration date (optional). Format: YYYY-MM-DD. Example: 2024-12-31
• AccountId: The associated account/company ID (optional). For B2B quotes, link to the company. How to get: Use 'Search Accounts' action.
• ContactId: The associated contact/person ID (optional). For B2C quotes, link to the individual. How to get: Use 'Search Contacts' action.
• Quantity: The quantity of the product (optional, default 1). Must be a positive integer.
• ListPrice: The unit price per product (optional). If not provided, uses the product's default price. Example: 99.99
• Description: The description (optional).
• QuoteId: The ID of existing quote to update (optional). If provided, updates directly. How to get: Use 'Search Quotes' or 'Get Many Quotes' action.
• AdditionalFields: Additional fields as an object (optional). Common fields: Terms_and_Conditions (string: terms text), Discount (number: discount amount), Tax (number: tax amount), Adjustment (number: adjustment amount). For multiple line items, override Quoted_Items array. Example: {"Terms_and_Conditions": "Net 30", "Discount": 100}
• DuplicateCheckFields: Comma-separated field names for duplicate check (optional). If a matching record is found, Zoho updates it instead of creating a duplicate. Leave empty to use Subject by default. Example: Subject or Subject,Account_Name

Output:

• CreatedOrUpdatedQuote (object): Details of the created or updated quote. Contains: id (string, Quote unique ID), Created_Time (string, ISO 8601), Modified_Time (string, ISO 8601), action (string, 'insert' or 'update').
• OriginalStatusCode (number): The raw HTTP status code returned by the Zoho CRM API (e.g., 200 for success, 429 for rate limited, 400 for bad request).
• StatusCode (number): Operation result code: 200 (success or business error, check ErrorMessage), -1 (parameter validation error), 500 (system/network error).
• ErrorMessage (string): Any error message.

Delete a Quote

Permanently deletes a Quote from Zoho CRM.

Input Parameters:

• QuoteId: The unique ID of the Quote to be deleted. It can be obtained through the Search Quotes or Get Many Quotes interface. The format is a numeric string generated by the Zoho system, such as "4150868000001234567".

Options:

• ZohoUrl: Zoho CRM server address. Typically, there is no need to modify it; the default value is sufficient. If you are using Zoho in the European region (zohoapis.eu), Chinese region (zohoapis.com.cn), or Australian region (zohoapis.com.au), please contact your administrator for the correct address.

Output:

• DeletedQuote (object): The deleted quote object containing id (deleted quote ID) and status ("deleted").
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (not found, validation, rate limits), or system error info.

Get a Quote

Retrieves a Quote from Zoho CRM by ID.

Input Parameters:

• QuoteId: The unique ID of the quote to retrieve (required). Get this ID via Search Quotes or Get Many Quotes actions.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• Fields: Comma-separated list of field API names to retrieve (optional). Leave empty to retrieve all default fields. Example: Subject,Total,Valid_Till

Output:

• Quote (object): The quote object containing id, Subject, Total, Valid_Till, Quote_Stage, Account_Name, Contact_Name, Created_Time, Modified_Time, and Owner.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (not found, validation, rate limits), or system error info.

Get Many Quotes

Retrieves Quotes from Zoho CRM with pagination.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• PerPage: Number of records per page. Range: 1-200. Default: 200.
• Page: Page number for pagination. Starts from 1. Default: 1.
• AdditionalFields: Comma-separated list of additional field API names to include in results (optional). Leave empty to retrieve default fields. Example: Custom_Field_1,Custom_Field_2

Output:

• Quotes (object-array): Array of quote objects. Each contains id, Subject, Quote_Stage, Valid_Till, Grand_Total, Sub_Total, Tax, Discount, Account_Name, Contact_Name, Deal_Name, Owner, Created_Time, Modified_Time, and any additional fields requested.
• Info (object): Pagination metadata object with per_page (records per page), page (current page), count (records in current response), more_records (boolean indicating if more pages exist).
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (no quotes, rate limits), or system error info.

Search Quotes

Searches quotes in Zoho CRM using advanced criteria or keywords.

Options:

• ZohoUrl: The base URL of the Zoho CRM instance. Default is https://www.zohoapis.com for US datacenter. If you are using EU/CN/IN datacenter, please use the corresponding URL (e.g., https://www.zohoapis.eu for EU). Most users can keep the default value. This field is optional and defaults to the US datacenter URL if left empty.
• Criteria: ⚠️ Priority 1 - Advanced search expression. MUTUALLY EXCLUSIVE with Keyword (if provided, Keyword is ignored). Format: (Field:Operator:Value). Operators: equals, starts_with, contains, greater_than, less_than. Combine with 'and'/'or'. Examples: (Subject:starts_with:Q-) or (Quote_Stage:equals:Delivered)and(Grand_Total:greater_than:10000). Leave empty to use Keyword.
• Keyword: ⚠️ Priority 2 - Fuzzy keyword search across multiple fields. MUTUALLY EXCLUSIVE with Criteria. Only used if Criteria is empty. Example: Q-2024-001. ⚠️ Use only ONE search method at a time.
• PerPage: Number of records per page (max 200). Default is 200 if not specified.
• Page: Page number to retrieve. Default is 1 if not specified.
• AdditionalFields: Comma-separated list of additional fields to retrieve. Example: 'Custom_Field_1,Custom_Field_2,Owner_Name'

Output:

• Quotes (object-array): List of quotes matching the search criteria. Each quote object contains fields like: Id (string), Subject (string), Quote_Stage (string), Valid_Till (string), Grand_Total (number), Sub_Total (number), Tax (number), Account_Name (string), Contact_Name (string), Deal_Name (string), Owner (object), Created_Time (string), Modified_Time (string), and other fields specified in AdditionalFields parameter.
• Info (object): Pagination metadata object containing: count (number) - number of records in current response, more_records (boolean) - whether there are more records available, per_page (number) - records per page, page (number) - current page number.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 204, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (invalid criteria, rate limits), or system error info.

Update a Quote

Updates an existing Quote in Zoho CRM.

Input Parameters:

• QuoteId: The unique ID of the quote to update (required). You can obtain this ID through: Search Quotes or Get Many Quotes action, or from the response of Create Quote action.

Options:

• ZohoUrl: Zoho CRM API base URL (usually no need to modify, use default value). If you are using Zoho in Europe or China region, please contact your administrator for the correct URL.
• Subject: The new subject/title of the quote (optional). Supports up to 255 characters. This is the main identifier shown in quote lists.

Example: Q2 2026 Enterprise License Proposal

• QuoteStage: The new stage of the quote (optional). Quote lifecycle stages:
• Draft: Initial quote draft, not yet sent to customer
• Negotiation: Under negotiation with customer
• Delivered: Quote has been sent/delivered to customer
• On Hold: Temporarily paused, waiting for customer decision
• Confirmed: Customer accepted the quote
• Closed Won: Quote converted to order/deal
• Closed Lost: Customer rejected or quote expired
• ValidTill: The new validity/expiration date of the quote in YYYY-MM-DD format (optional). Example: 2026-12-31
• AccountId: The new associated account (company) ID (optional). You can obtain this ID through: Search Accounts or Get Many Accounts action.
• ContactId: The new associated contact person ID (optional). You can obtain this ID through: Search Contacts or Get Many Contacts action. This is the main contact for this quote.
• ProductId: The product ID for line item (optional). You can obtain this ID through: Search Products or Get Many Products action. Used together with Quantity and ListPrice to update quote items.

⚠️ NOTE: Currently only supports updating a single product line item. For multiple products, call this action multiple times or use the AdditionalFields parameter with Quoted_Items array.

Example: 3652397000000856001

• Quantity: The quantity of the product (optional, default 1).
• ListPrice: The unit price of the product (optional).
• Description: The new internal description/notes for the quote (optional). Supports up to 32,000 characters. Use this field to record important details, special terms, or internal notes.

Example: Customer requested 10% discount for annual commitment. Include implementation services.

• AdditionalFields: ⚠️ Advanced option: Additional quote fields as an object. Only use when you need to update non-standard or custom fields. Keys must be valid Zoho CRM field API names.

Common fields:

• Discount (number): Discount amount
• Tax (number): Tax amount
• Terms_and_Conditions (string): Payment terms
• Adjustment (number): Adjustment amount

Example: {"Discount": 10, "Tax": 50, "Terms_and_Conditions": "Net 30 days"}

Output:

• UpdatedQuote (object): The updated Quote object containing the following core fields:
• id (string): Quote unique identifier
• Created_Time (string): Creation time in ISO 8601 format
• Modified_Time (string): Last modification time
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (invalid ID, validation failures, rate limits), or system error info.

Create a Sales Order

Creates a sales order in Zoho CRM for customer purchases.

Input Parameters:

• Subject: The subject/title of the sales order (required). Example: 'SO-2024-001 Enterprise License'.
• ProductId: The unique ID of the product to sell (required). You can obtain this ID through: Search Products or Get Many Products action.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• Status: The current status of the sales order (optional). Supported values: Created, Approved, Delivered, Cancelled.
• AccountId: The unique ID of the customer company/account (optional). You can obtain this ID through: Search Accounts or Get Many Accounts action.
• ContactId: The unique ID of the contact person at the customer (optional). You can obtain this ID through: Search Contacts or Get Many Contacts action.
• DueDate: Expected delivery date in YYYY-MM-DD format (optional). Example: '2024-12-31'.
• Quantity: The quantity of products to sell (optional, default 1). Must be a positive number. Example: 5.
• ListPrice: The unit price per product in your account default currency (optional). If 0 or not set, uses the product's default price. Example: 99.99.
• Description: Additional notes or terms for this sales order (optional). Example: 'Urgent delivery requested'.
• AdditionalFields: Additional sales order fields as an object (optional). Use Zoho CRM field API names as keys. Refer to Zoho CRM API documentation for field-specific data type requirements. Example: {"Deal_Name": {"id": "xxx"}, "Carrier": "FedEx"}
• DuplicateCheckFields: Comma-separated field names for duplicate check (optional). If a matching record is found, Zoho returns an error instead of creating a duplicate. Leave empty to skip duplicate check. Example: Subject

Output:

• CreatedSalesOrder (object): The created sales order object containing id, Subject, Status, Grand_Total, Due_Date, Created_Time, Modified_Time, and Owner.
• OriginalStatusCode (number): The raw HTTP status code returned by the Zoho CRM API (e.g., 200 for success, 429 for rate limited, 400 for bad request).
• StatusCode (number): Operation result code: 200 (success or business error, check ErrorMessage), -1 (parameter validation error), 500 (system/network error).
• ErrorMessage (string): Detailed error description. Empty string when successful. When rate limited (429), includes retry wait time.

Create or Update a Sales Order

Creates or updates a Sales Order in Zoho CRM.

Input Parameters:

• Subject: The subject/title of the sales order (required). Used for duplicate checking - if a sales order with this subject exists, it will be updated instead of creating a new one. Example: 'SO-2024-001 Enterprise'.
• ProductId: The unique ID of the product to sell (required). This action supports one product per order. You can obtain this ID through: Search Products or Get Many Products action.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• Status: The current status of the sales order (optional). Supported values: Created, Approved, Delivered, Cancelled.
• AccountId: The unique ID of the customer company/account (optional). You can obtain this ID through: Search Accounts or Get Many Accounts action.
• ContactId: The unique ID of the contact person at the customer (optional). You can obtain this ID through: Search Contacts or Get Many Contacts action.
• DueDate: Expected delivery date in YYYY-MM-DD format (optional). Example: '2024-12-31'.
• Quantity: The quantity of products to sell (optional, default 1). Must be a positive number. Example: 5.
• ListPrice: The unit price per product in your account default currency (optional). If 0 or not set, uses the product's default price. Example: 99.99.
• Description: Additional notes or terms for this sales order (optional). Example: 'Standard delivery terms apply'.
• SalesOrderId: The ID of an existing sales order to update (optional). If provided, updates the existing sales order directly. You can obtain this ID through: Search Sales Orders or Get Many Sales Orders action.
• AdditionalFields: Additional sales order fields as an object (optional). Use Zoho CRM field API names as keys. Refer to Zoho CRM API documentation for field-specific data type requirements. Example: {"Carrier": "UPS", "Discount": 100}
• DuplicateCheckFields: Comma-separated field names for duplicate check (optional). When creating or updating, if a matching record is found by these fields, it will be updated instead of creating a new one. Leave empty to use default (Subject). Example: Subject or Subject,AccountId

Output:

• CreatedOrUpdatedSalesOrder (object): The created or updated sales order object containing id, Subject, Status, Grand_Total, Due_Date, Created_Time, Modified_Time, and Owner.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (duplicates, validation, rate limits), or system error info.

Delete a Sales Order

Permanently deletes a Sales Order from Zoho CRM.

Input Parameters:

• SalesOrderId: The unique ID of the sales order to delete (required). You can obtain this ID through: Search Sales Orders or Get Many Sales Orders action, or from the response of Create Sales Order action.

Options:

• ZohoUrl: Zoho CRM API base URL. Default: https://www.zohoapis.com (US). For EU use https://www.zohoapis.eu, for China https://www.zohoapis.com.cn, for India https://www.zohoapis.in.

Output:

• DeletedSalesOrder (object): The deleted sales order object containing id (deleted sales order ID) and status (always 'deleted' on success).
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (not found, validation, rate limits), or system error info.

Get a Sales Order

Retrieves a Sales Order from Zoho CRM by ID.

Input Parameters:

• SalesOrderId: The unique ID of the sales order to retrieve (required). You can obtain this ID through: Search Sales Orders or Get Many Sales Orders action, or from the response of Create Sales Order action.

Options:

• ZohoUrl: Zoho CRM API base URL. Default: https://www.zohoapis.com (US). For EU use https://www.zohoapis.eu, for China https://www.zohoapis.com.cn, for India https://www.zohoapis.in.
• AdditionalFields: Comma-separated field names to include beyond default fields. Use Zoho CRM field API names. Example: Custom_Field_1,Special_Instructions

Output:

• SalesOrder (object): The sales order object retrieved from Zoho CRM containing all sales order details including id, Subject, Status, Grand_Total, Due_Date, Account_Name, Contact_Name, Ordered_Items, and other fields.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (not found, validation, rate limits), or system error info.

Get Many Sales Orders

Retrieves Sales Orders from Zoho CRM with pagination.

Options:

• ZohoUrl: Zoho CRM API base URL. Default: https://www.zohoapis.com (US). For EU use https://www.zohoapis.eu, for China https://www.zohoapis.com.cn, for India https://www.zohoapis.in.
• PerPage: Number of sales orders to retrieve per page (optional, default 200). Valid range: 1-200. Example: 50.
• Page: Page number to retrieve (optional, default 1, 1-based). Use with PerPage for pagination. Check Info.more_records in response to determine if more pages exist. Example: 1.
• AdditionalFields: Comma-separated field names to include in response (optional). Leave empty to use default fields. Use '*' to retrieve all available fields (may impact performance). Example: 'Excise_Duty,Sales_Commission'.

Output:

• SalesOrders (object-array): Array of sales order objects. Each object contains: id, Subject, Status, Grand_Total, Due_Date, Account_Name, Contact_Name, Ordered_Items, and other fields as requested.
• Info (object): Pagination metadata object containing: per_page (records per page), page (current page number), count (records in current page), more_records (boolean - true if additional pages exist).
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (no orders, rate limits), or system error info.

Search Sales Orders

Searches sales orders in Zoho CRM using advanced criteria or keywords.

Options:

• ZohoUrl: Zoho CRM API base URL. Default: https://www.zohoapis.com (US). For EU use https://www.zohoapis.eu, for China https://www.zohoapis.com.cn, for India https://www.zohoapis.in.
• Criteria: ⚠️ Priority 1 - Advanced search expression. MUTUALLY EXCLUSIVE with Keyword (if provided, Keyword is ignored). Format: (Field:Operator:Value). Operators: equals, starts_with, contains, greater_than, less_than. Combine with 'and'/'or'. Examples: (Subject:starts_with:SO-) or (Subject:starts_with:SO-)and(Status:equals:Created). Leave empty to use Keyword.
• Keyword: ⚠️ Priority 2 - Fuzzy keyword search across multiple fields. MUTUALLY EXCLUSIVE with Criteria. Only used if Criteria is empty. Example: Enterprise Customer. ⚠️ Use only ONE search method at a time.
• PerPage: Number of records to retrieve per page (optional, default 200). Valid range: 1-200. Example: 50.
• Page: Page number to retrieve (optional, default 1, 1-based). Use with PerPage for pagination. Check Info.more_records in response to determine if more pages exist. Example: 1.
• AdditionalFields: Comma-separated field names to include in response (optional). Leave empty to use default fields. Use '*' to retrieve all available fields (may impact performance). Example: 'Excise_Duty,Sales_Commission'.

Output:

• SalesOrders (object-array): Array of sales order objects matching the search criteria. Each object contains: id, Subject, Status, Grand_Total, Due_Date, Account_Name, Contact_Name, Ordered_Items, and other fields as requested.
• Info (object): Pagination metadata object containing: per_page (records per page), page (current page number), count (records in current page), more_records (boolean - true if additional pages exist).
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 204, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (invalid criteria, rate limits), or system error info.

Update a Sales Order

Updates an existing Sales Order in Zoho CRM.

Input Parameters:

• SalesOrderId: The unique ID of the sales order to update (required). You can obtain this ID through: Search Sales Orders or Get Many Sales Orders action, or from the response of Create Sales Order action.

Options:

• ZohoUrl: Zoho CRM API base URL. Default: https://www.zohoapis.com (US). For EU use https://www.zohoapis.eu, for China https://www.zohoapis.com.cn, for India https://www.zohoapis.in.
• Subject: The subject/title of the sales order (optional). Example: 'SO-2024-001 Enterprise'.
• Status: The status of the sales order (optional). Supported values: Created, Approved, Delivered, Cancelled.
• AccountId: The unique ID of the customer company/account (optional). You can obtain this ID through: Search Accounts or Get Many Accounts action.
• ContactId: The unique ID of the contact person at the customer (optional). You can obtain this ID through: Search Contacts or Get Many Contacts action.
• DueDate: Expected delivery date in YYYY-MM-DD format (optional). Example: '2024-12-31'.
• ProductId: The unique ID of the product to update in line items (optional). This action supports one product per request. You can obtain this ID through: Search Products or Get Many Products action.
• Quantity: The quantity of products (optional, default 1). Must be a positive number. Example: 5.
• ListPrice: The unit price per product in your account default currency (optional). If 0 or not set, uses the product's default price. Example: 99.99.
• Description: Additional notes or terms for this sales order (optional). Example: 'Standard delivery terms apply'.
• AdditionalFields: Additional sales order fields as an object (optional). Use Zoho CRM field API names as keys. Refer to Zoho CRM API documentation for field-specific data type requirements. Example: {"Carrier": "UPS", "Discount": 100}

Output:

• UpdatedSalesOrder (object): The updated sales order object containing id, Subject, Status, Created_Time, Modified_Time.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (invalid ID, validation failures, rate limits), or system error info.

Create a Vendor

Creates a vendor/supplier in Zoho CRM for procurement management.

Input Parameters:

• VendorName: The company name of the vendor/supplier (required). Example: 'Acme Supplies Inc.'.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for US region. EU: https://www.zohoapis.eu, China: https://www.zohoapis.com.cn, India: https://www.zohoapis.in
• Email: Primary contact email for the vendor (optional). Must be a valid email format. Example: 'contact@acmesupplies.com'.
• Phone: Primary phone number for the vendor (optional). Supports various international formats. Example: '+1-555-123-4567'.
• Website: Vendor's website URL (optional). Must be a valid URL format. Example: 'https://www.acmesupplies.com'.
• City: City where the vendor is located (optional). Example: 'New York'.
• AdditionalFields: Additional vendor fields as an object (optional). Use Zoho CRM field API names as keys. Refer to Zoho CRM API documentation for field-specific data type requirements. Example: {"Street": "123 Main St", "Country": "United States", "GL_Account": "2000"}
• DuplicateCheckFields: Comma-separated field names for duplicate check (optional). If a matching record is found, Zoho returns an error instead of creating a duplicate. Leave empty to skip duplicate check. Example: Email or Vendor_Name,Email

Output:

• CreatedVendor (object): The created vendor object containing id, Vendor_Name, Email, Phone, Website, City, Created_Time, Modified_Time, and Owner.
• OriginalStatusCode (number): The raw HTTP status code returned by the Zoho CRM API (e.g., 200 for success, 429 for rate limited, 400 for bad request).
• StatusCode (number): Operation result code: 200 (success or business error, check ErrorMessage), -1 (parameter validation error), 500 (system/network error).
• ErrorMessage (string): Detailed error description. Empty string when successful. When rate limited (429), includes retry wait time.

Create or Update a Vendor

Creates or updates a Vendor in Zoho CRM.

Input Parameters:

• VendorName: The name of the vendor/supplier (required). Used for duplicate checking - if a vendor with this name exists, it will be updated instead of creating a new one. Example: 'Acme Supplies Inc.'.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• Email: The email address of the vendor (optional). Must be a valid email format. Example: 'contact@acmesupplies.com'.
• Phone: The phone number of the vendor (optional). Supports various international formats. Example: '+1-555-123-4567'.
• Website: The website of the vendor (optional). Must be a valid URL format. Example: 'https://www.acmesupplies.com'.
• City: The city where the vendor is located (optional). Example: 'New York'.
• VendorId: The ID of an existing vendor to update (optional). If provided, updates the existing vendor directly. You can obtain this ID through: Search Vendors or Get Many Vendors action, or from the response of Create Vendor action.
• AdditionalFields: Additional vendor fields as an object (optional). Use Zoho CRM field API names as keys. Refer to Zoho CRM API documentation for field-specific data type requirements. Example: {"Description": "Main supplier", "Street": "123 Main St", "Country": "United States"}
• DuplicateCheckFields: Comma-separated field names for duplicate check (optional). When creating or updating, if a matching record is found by these fields, it will be updated instead of creating a new one. Leave empty to use default (Vendor_Name). Example: Email or Vendor_Name,Email

Output:

• CreatedOrUpdatedVendor (object): The created or updated vendor object containing id, Vendor_Name, Email, Phone, Website, City, Created_Time, Modified_Time, and Owner.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (duplicates, validation, rate limits), or system error info.

Delete a Vendor

Permanently deletes a Vendor from Zoho CRM.

Input Parameters:

• VendorId: The unique ID of the vendor to delete (required). You can obtain this ID from 'Search Vendors' or 'Get Many Vendors' action. Format: Zoho-generated numeric string (e.g., '4150868000001234567').

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).

Output:

• DeletedVendor (object): The deletion result object containing id (string, the deleted vendor's unique ID) and status (string, fixed value 'deleted').
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (not found, validation, rate limits), or system error info.

Get a Vendor

Retrieves a Vendor from Zoho CRM by ID.

Input Parameters:

• VendorId: The unique ID of the vendor to retrieve (required). You can obtain this ID from 'Search Vendors' or 'Get Many Vendors' action, or from the response of other vendor operations.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• Fields: Comma-separated list of field API names to retrieve (optional). Example: 'Vendor_Name,Email,Phone'. If not specified, all fields will be returned.

Output:

• Vendor (object): The vendor object containing core fields: id (string, unique identifier), Vendor_Name (string), Email (string), Phone (string), Website (string), City (string), State (string), Country (string), Description (string), Created_Time (string, ISO 8601), Modified_Time (string, ISO 8601), and Owner (object). Refer to Zoho CRM API documentation for complete field list.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string when successful. Includes error details for business errors (not found, validation, rate limits), or system error info.

Get Many Vendors

Retrieves Vendors from Zoho CRM with pagination.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• PerPage: Number of records per page. Range: 1-200. Default: 200.
• Page: Page number for pagination. Starts from 1. Default: 1.
• AdditionalFields: Comma-separated field names to include in results. Leave empty to retrieve default fields. Example: Field_1,Field_2

Output:

• Vendors (object-array): Array of Vendor objects. Each object contains: Id (string, unique identifier), Vendor_Name (string), Email (string), Phone (string), Website (string), GL_Account (string), Category (string), Street (string), City (string), State (string), Country (string), Zip_Code (string), Description (string), Owner (object with id and name), Created_Time (string, ISO 8601), Modified_Time (string, ISO 8601). Additional fields depend on AdditionalFields parameter.
• Info (object): Pagination metadata object containing: per_page (number, records per page), page (number, current page), count (number, total records in current page), more_records (boolean, true if more pages exist). Use more_records to determine if you need to fetch the next page.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (no vendors, rate limits), or system error info.

Search Vendors

Searches vendors in Zoho CRM using advanced criteria, email, phone, or keyword.

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• Criteria: ⚠️ Priority 1 - Advanced search expression. MUTUALLY EXCLUSIVE with Email/Phone/Keyword (if provided, others are ignored). Format: (Field:Operator:Value). Operators: equals, starts_with, contains, greater_than, less_than. Combine with 'and'/'or'. Examples: (Vendor_Name:starts_with:ABC) or (Vendor_Name:starts_with:ABC)and(City:equals:Shanghai). Leave empty to use Email/Phone/Keyword.
• Email: ⚠️ Priority 2 - Search by exact email match. MUTUALLY EXCLUSIVE with Criteria/Phone/Keyword. Only used if Criteria is empty. Example: vendor@example.com. Leave empty to use Phone or Keyword.
• Phone: ⚠️ Priority 3 - Search by exact phone match. MUTUALLY EXCLUSIVE with Criteria/Email/Keyword. Only used if Criteria and Email are empty. Example: +1-555-123-4567. Leave empty to use Keyword.
• Keyword: ⚠️ Priority 4 - Fuzzy keyword search across multiple fields. MUTUALLY EXCLUSIVE with Criteria/Email/Phone. Only used if all others are empty. Example: Technology. ⚠️ Use only ONE search method at a time.
• PerPage: Number of records per page. Range: 1-200. Default: 200.
• Page: Page number for pagination. Starts from 1. Default: 1.
• AdditionalFields: Comma-separated field names to include in results. Leave empty to retrieve default fields. Example: Field_1,Field_2

Output:

• Vendors (object-array): List of vendors matching the search criteria. Each vendor object contains: Id (string, unique identifier), Vendor_Name (string), Email (string), Phone (string), Website (string), GL_Account (string), Category (string), Street (string), City (string), State (string), Country (string), Zip_Code (string), Description (string), Owner (object with id and name), Created_Time (string, ISO 8601), Modified_Time (string, ISO 8601). Additional fields depend on AdditionalFields parameter.
• Info (object): Pagination metadata object containing: per_page (number, records per page), page (number, current page), count (number, total records in current page), more_records (boolean, true if more pages exist). Use more_records to determine if you need to fetch the next page.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 204, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (invalid criteria, rate limits), or system error info.

Update a Vendor

Updates an existing Vendor in Zoho CRM.

Input Parameters:

• VendorId: The ID of the vendor to update (required). You can obtain this ID from Search Vendors or Get Many Vendors action. Example: 5725767000000524001

Options:

• ZohoUrl: Zoho CRM API base URL. Default works for most users (US region). Only change if using a different region: EU (https://www.zohoapis.eu), China (https://www.zohoapis.com.cn), India (https://www.zohoapis.in).
• VendorName: The new name of the vendor (optional). Example: Acme Corporation
• Email: The new email address of the vendor (optional). Example: vendor@acme.com
• Phone: The new phone number of the vendor (optional). Example: +1-555-0123
• Website: The new website URL (optional). Example: https://www.acme.com
• City: The new city of the vendor (optional). Example: San Francisco
• AdditionalFields: Additional vendor fields as an object (optional). Use Zoho CRM field API names as keys. Example: {"Description": "Main supplier", "Country": "United States"}

Output:

• UpdatedVendor (object): The updated vendor object containing id, Created_Time, Modified_Time.
• OriginalStatusCode (number): Raw HTTP status code from Zoho API (200, 400, 401, 404, 429, 500, 503, 504, etc.). Use for debugging. 0 if request failed before receiving a response.
• StatusCode (number): Operation result: 200=success or business error (check ErrorMessage), 500=system error (network/parsing), -1=parameter validation error.
• ErrorMessage (string): Detailed error or status message. Empty when successful. Includes error details for business errors (invalid ID, validation failures, rate limits), or system error info.

5. Example Usage

This section will guide you through creating a simple workflow to create a new lead in your Zoho CRM.

Workflow Overview:

Our example workflow consists of three nodes: Start → Zoho CRM → Answer. This workflow captures lead information and creates a new lead record in Zoho CRM.

Step-by-Step Guide:

1. Add the Tool Node:
   • Click the "+" button on the workflow canvas to add a new node.
   • Select the "Tools" tab in the popup panel.
   • Find and select "Zoho CRM" from the tool list.
   • In the list of supported operations, click "Create a Lead" to add this node to the canvas.
2. Configure the Node:
   • Click the newly added "Create a Lead" node. The configuration panel will open on the right side.
   • Credentials Configuration: At the top of the panel, locate the credentials field. Click the dropdown menu and select your pre-configured Zoho CRM credentials.
   • Parameter Configuration: Fill in the required parameters:
   • LastName: Enter the last name of the lead (required field). For example: 'Johnson'.
   • FirstName: Enter the first name (optional). For example: 'Sarah'.
   • Company: Enter the company name (optional). For example: 'Tech Solutions Inc.'.
   • Email: Enter the email address (optional). For example: 'sarah.johnson@techsolutions.com'.
   • Phone: Enter the phone number (optional). For example: '+1-555-0123'.
   • LeadSource: Select or enter the lead source (optional). For example: 'Web Download' or 'Trade Show'.
3. Run and Verify:
   • Once all required parameters are correctly filled, the error indicator on the canvas will disappear.
   • Click the "Test Run" button in the upper right corner of the canvas to execute the workflow.
   • After successful execution, click the log icon in the upper right corner to view the node's detailed input and output, verifying that the lead was created successfully.

Final Workflow:

After completing the above steps, your entire workflow is configured. Click "Test Run" and a new lead will be successfully created in your Zoho CRM with all the provided information.

6. FAQs

Q: What should I do if I encounter a 401 or 403 authentication error?

A: This typically indicates an authentication or authorization issue. Please check the following:

• Ensure your Zoho CRM credentials are correctly configured in GoInsight.
• Verify that your OAuth token has not expired. Zoho CRM tokens typically need to be refreshed periodically.
• Confirm that your Zoho CRM account has the necessary permissions to perform the requested operation.
• Check if you're using the correct regional API endpoint (US, EU, India, China, or Australia).

Q: How do I handle rate limiting (429 errors)?

A: Zoho CRM enforces API rate limits to ensure service stability. When you encounter a 429 error:

• The error message will include a "Retry-After" value indicating how many seconds to wait.
• Implement exponential backoff in your workflow logic.
• Consider reducing the frequency of API calls or batching operations when possible.
• Review Zoho CRM's API rate limit documentation for your specific plan tier.

Q: Which fields are required when creating records?

A: Required fields vary by record type:

• Lead: LastName (required)
• Contact: LastName (required)
• Account: AccountName (required)
• Deal: DealName and Stage (required)
• Product: ProductName (required)

Other fields are optional but recommended for better data quality. Your Zoho CRM administrator may have configured additional mandatory fields.

Q: How do I use custom fields?

A: Most create and update operations support an AdditionalFields parameter that accepts an object:

• Use the exact API name of your custom field as the key (e.g., Custom_Field_1__c).
• Ensure the value matches the field's data type (string, number, boolean, date, etc.).
• You can use the "Get Module Fields" or "Get Lead Fields" operations to discover available field names and their types.
• Example: {"Industry": "Technology", "Rating": "Hot", "Custom_Score__c": 85}

Q: What is the difference between "Create" and "Create or Update" operations?

A:

• Create: Always creates a new record. If a duplicate exists, it may create a duplicate record or return an error (depending on your duplicate checking settings).
• Create or Update (Upsert): Searches for an existing record based on specified criteria. If found, it updates the existing record; if not found, it creates a new one. This is useful for data synchronization scenarios.

7. Official Documentation

For more detailed information about Zoho CRM APIs, data models, and advanced features, please refer to:

Zoho CRM Official API Documentation