- Category: crm
- Auth: OAUTH2
- Composio-managed OAuth available? Yes
- Tools: 103
- Triggers: 0
- Slug:
ZOHO - Version: 20261103_00
Frequently Asked Questions
How do I set up custom OAuth credentials for Zoho CRM?
How do I set up custom OAuth credentials for Zoho CRM?
Tools
Associate Email with Zoho CRM Record
Associate Email with Zoho CRM Record
Convert Zoho CRM Lead
Convert Zoho CRM Lead
Count Zoho CRM Records
Count Zoho CRM Records
ZOHO_COUNT_RECORDSCount all records or records matching one filter in a Zoho CRM module.Input Parameters
Output
Create Zoho CRM Automation Task
Create Zoho CRM Automation Task
ZOHO_CREATE_AUTOMATION_TASKCreate an automation task with typed static, merge, date, or datetime mappings.Input Parameters
Output
Create Contact in Zoho CRM
Create Contact in Zoho CRM
Create Zoho CRM Custom Fields
Create Zoho CRM Custom Fields
Create Zoho CRM Custom View
Create Zoho CRM Custom View
ZOHO_CREATE_CUSTOM_VIEWCreate one custom view for a Zoho CRM module.Input Parameters
Output
Create Deal in Zoho CRM
Create Deal in Zoho CRM
ZOHO_CREATE_DEALCreates a new deal in Zoho CRM representing a sales opportunity with deal name, stage, amount, and closing date. Use this action when you need to create a sales deal or opportunity in Zoho CRM. Required fields are Deal_Name and Stage; all other fields are optional. The deal will be assigned to the authenticated user unless an Owner is explicitly specified.Input Parameters
Output
Create Email Draft in Zoho CRM
Create Email Draft in Zoho CRM
ZOHO_CREATE_EMAIL_DRAFTCreates email drafts for a specific record in Zoho CRM. Email drafts are saved but not sent, allowing for review and editing before sending. Use this action when you need to prepare email communications associated with CRM records (Leads, Contacts, Deals, etc.) that will be reviewed and sent later. The draft will be visible in the record’s timeline and can be edited or sent through the Zoho CRM interface.Input Parameters
Output
Create Zoho Event
Create Zoho Event
ZOHO_CREATE_EVENTCreates a new Event record in Zoho CRM. Events represent scheduled activities like meetings, calls, or appointments. Use this action when you need to schedule a new event or meeting in the CRM system. All events require an event title, start time, and end time at minimum.Input Parameters
Output
Create Zoho CRM Function
Create Zoho CRM Function
ZOHO_CREATE_FUNCTIONCreate a Zoho CRM function. Deluge code is optional and auto-published. Java, Node.js, and Python require a ZIP package and remain drafts unless publish_changelog requests publication.Input Parameters
Output
Create Lead in Zoho CRM
Create Lead in Zoho CRM
ZOHO_CREATE_LEADCreates a new lead record in Zoho CRM with the specified details. The only mandatory field is Last_Name - all other fields are optional. Use this action when you need to add a new lead to Zoho CRM, typically after capturing lead information from a web form, email, or other lead generation source. The action returns the newly created lead ID and metadata including creation timestamps and user information.Input Parameters
Output
Create Note in Zoho CRM
Create Note in Zoho CRM
ZOHO_CREATE_NOTECreates a new note attached to a specific record in Zoho CRM. Notes are text annotations that can be added to any standard or custom module record. Use this action when you need to add notes, comments, or text-based documentation to a record in Zoho CRM. The note will be visible in the record’s Notes related list.Input Parameters
Output
Create Zoho CRM Workflow Rule
Create Zoho CRM Workflow Rule
Create Zoho CRM Record
Create Zoho CRM Record
ZOHO_CREATE_ZOHO_RECORDCreates new records in a specified Zoho CRM module. Bulk operations may partially succeed; an item failure raises an error even when other records were created.Input Parameters
Output
Create Zoho CRM Tag
Create Zoho CRM Tag
ZOHO_CREATE_ZOHO_TAGCreates a new tag in Zoho CRM for a specific module. Tags help organize and categorize CRM records. Each module can have up to 100 tags, and each record can have up to 10 tags assigned. Tags must have unique names within a module and can be assigned custom colors from a predefined palette. Creating a tag does not apply it to any records; use separate update actions to assign the tag to records. Use this action to create standardized tags for lead scoring, deal stages, customer segments, or any custom categorization needs in your CRM workflow.Input Parameters
Output
Delete Zoho Account
Delete Zoho Account
ZOHO_DELETE_ACCOUNTDeletes an existing account record from Zoho CRM. This action permanently removes the account and cannot be undone through the API. Use this action when you need to remove an account record that is no longer needed or was created in error. This action is irreversible — the account cannot be recovered once deleted.Input Parameters
Output
Delete Zoho CRM Contact
Delete Zoho CRM Contact
Delete Zoho CRM Deal
Delete Zoho CRM Deal
ZOHO_DELETE_DEALDeletes a deal record from Zoho CRM. This action is irreversible — once deleted, the deal cannot be recovered. Use this action when you need to permanently remove a deal from the CRM system. The deal will be moved to the recycle bin initially and can be restored from there within the configured retention period (typically 60 days), after which permanent deletion occurs automatically.Input Parameters
Output
Delete Zoho CRM Email Draft
Delete Zoho CRM Email Draft
Delete Zoho CRM Event
Delete Zoho CRM Event
ZOHO_DELETE_EVENTMove one Zoho CRM Event record to the recycle bin. Omitting wf_trigger uses Zoho’s default of true, so workflows and notifications can run.Input Parameters
Output
Delete Zoho CRM Lead
Delete Zoho CRM Lead
Delete Zoho CRM Note
Delete Zoho CRM Note
Delete Zoho CRM Records
Delete Zoho CRM Records
Delete Zoho CRM Tag
Delete Zoho CRM Tag
Download Zoho CRM Record Attachment
Download Zoho CRM Record Attachment
Download Zoho CRM Record Email Attachment
Download Zoho CRM Record Email Attachment
ZOHO_DOWNLOAD_RECORD_EMAIL_ATTACHMENTDownload one attachment from an email associated with a CRM record.Input Parameters
id query parameter.Output
Download Zoho CRM Record Photo
Download Zoho CRM Record Photo
Export Zoho CRM Audit Logs
Export Zoho CRM Audit Logs
Get Zoho CRM Account
Get Zoho CRM Account
ZOHO_GET_ACCOUNTRetrieves a specific Zoho CRM Account record by its unique identifier, with optional field selection. Single-record responses can provide access to subform records, multi-select lookup fields, and multi-user lookup fields.Input Parameters
Output
Get Zoho CRM Assignment Rule
Get Zoho CRM Assignment Rule
Get Zoho CRM Automation Task
Get Zoho CRM Automation Task
Get Zoho CRM Blueprint
Get Zoho CRM Blueprint
Get Zoho CRM Blueprint Transition
Get Zoho CRM Blueprint Transition
Get Call
Get Call
ZOHO_GET_CALLRetrieves a specific Call record by its unique identifier from Zoho CRM. Use this action when you need to fetch detailed information about a particular call, including its subject, duration, type, participants, outcome, and associated contacts or deals. This action is read-only and does not modify any data.Input Parameters
Output
Get Zoho CRM Contact
Get Zoho CRM Contact
ZOHO_GET_CONTACTRetrieves a single Zoho CRM contact record by ID, optionally selecting fields by their API names. Contact details may include owner information, account associations, address fields, and custom fields.Input Parameters
Output
Get Zoho CRM Custom Views
Get Zoho CRM Custom Views
Get Zoho CRM Deal
Get Zoho CRM Deal
Get Email Drafts for Zoho CRM Record
Get Email Drafts for Zoho CRM Record
ZOHO_GET_EMAIL_DRAFTSRetrieves email drafts associated with a specific record in Zoho CRM. Use this action when you need to view unsent email drafts that have been composed for a CRM record. This returns draft metadata including recipients, subject, attachments, and scheduling details; content and summary may be null.Input Parameters
Output
Get Zoho Event
Get Zoho Event
Get From Addresses
Get From Addresses
ZOHO_GET_FROM_ADDRESSESRetrieves the list of from addresses configured for email operations in Zoho CRM. Use this action when you need to get available email addresses for sending emails or configuring email settings. Returns the available primary, IMAP, and organization email addresses configured in the CRM.Output
Get Zoho CRM Kiosk States
Get Zoho CRM Kiosk States
Get Zoho CRM Layouts
Get Zoho CRM Layouts
Get Zoho CRM Module Fields Metadata
Get Zoho CRM Module Fields Metadata
ZOHO_GET_MODULE_FIELDSRetrieves field metadata for a Zoho CRM module including API names, data types, permissions, and configuration details. Use this tool to discover correct field names and types before creating or updating records, avoiding INVALID_DATA errors. Returns information about standard fields, custom fields, lookup fields, picklist options, and field-level permissions.Input Parameters
Output
Get Zoho CRM Note
Get Zoho CRM Note
ZOHO_GET_NOTERetrieves a single Zoho CRM note by its unique identifier, with a selectable set of fields. The default fields include the note’s title, content, parent record reference, owner details, and timestamps.Input Parameters
Output
Get Zoho CRM Organization Details
Get Zoho CRM Organization Details
Get Zoho CRM Pipelines
Get Zoho CRM Pipelines
Get Zoho CRM Product
Get Zoho CRM Product
Get Zoho CRM Profile
Get Zoho CRM Profile
Get Zoho CRM Record
Get Zoho CRM Record
ZOHO_GET_RECORDRetrieve one record from a standard or custom Zoho CRM module by ID. Use this generic action for custom modules and standard modules without a dedicated getter. Zoho truncates rich-text fields to 500 characters; use its Rich Text Fields API when full rich-text content is required.Input Parameters
Output
Get Zoho CRM Record Email
Get Zoho CRM Record Email
Get Zoho CRM Record Emails
Get Zoho CRM Record Emails
ZOHO_GET_RECORD_EMAILSRetrieves a page of emails associated with a specific record in Zoho CRM. Use this action when you need to fetch email history for a lead, contact, account, deal, or other CRM record. The response includes email metadata such as subject, sender, recipients, timestamps, and status information. Supports pagination for records with large email volumes.Input Parameters
Output
Get Zoho CRM Record Timeline
Get Zoho CRM Record Timeline
ZOHO_GET_RECORD_TIMELINERetrieve chronological field and related-record history for a Zoho CRM record.Input Parameters
Output
Get Zoho CRM Task
Get Zoho CRM Task
ZOHO_GET_TASKRetrieves a specific Zoho CRM task by its unique record ID, with an optional selection of fields. The returned record may include standard and custom fields, subforms, and multi-user lookup fields.Input Parameters
Output
Get Zoho CRM User
Get Zoho CRM User
ZOHO_GET_USERRetrieves a Zoho CRM user by ID, including name, email, role, profile, status, and preferences. Use ‘me’ as user_id to retrieve the currently authenticated user through Zoho’s CurrentUser listing; concrete user IDs are retrieved through the individual-user endpoint.Input Parameters
Output
Get Zoho CRM Webform
Get Zoho CRM Webform
Get Zoho CRM Workflow Rule
Get Zoho CRM Workflow Rule
Get Zoho CRM Records
Get Zoho CRM Records
ZOHO_GET_ZOHO_RECORDSRetrieves records from a specified module in Zoho CRM. Notes: - Discrete (page/per_page) pagination is limited to the first 2,000 records. To retrieve records beyond this, use token-based pagination via page_token from the previous response’s info.next_page_token. - Do not use page together with page_token. - You cannot use cvid together with sort_by.Input Parameters
Output
Get Zoho CRM Users
Get Zoho CRM Users
ZOHO_GET_ZOHO_USERSTool to retrieve users from Zoho CRM. Use when you need to fetch user information such as IDs, names, emails, roles, or status for setting Owner fields or performing user-related operations in CRM workflows.Input Parameters
Output
List Zoho CRM Access Settings
List Zoho CRM Access Settings
List Zoho CRM Accounts
List Zoho CRM Accounts
ZOHO_LIST_ACCOUNTSRetrieves a list of account records from Zoho CRM with pagination and filtering support. Use this action when you need to fetch multiple account records from the Accounts module, optionally filtered by territory, approval status, or custom views. Supports both discrete pagination (first 2,000 records) and token-based pagination for larger datasets.Input Parameters
Output
List Zoho CRM Cadences
List Zoho CRM Cadences
ZOHO_LIST_CADENCESList Zoho CRM cadence definitions using optional filters.Input Parameters
Output
List Zoho CRM Calls
List Zoho CRM Calls
ZOHO_LIST_CALLSRetrieves Call activity records from Zoho CRM with pagination support. Use this action when you need to list calls logged in the CRM, filter by custom views, or retrieve specific Call records by ID. Call records represent phone call activities associated with Contacts, Leads, or other CRM records.Input Parameters
Output
List Zoho CRM Connected Workflow Rules
List Zoho CRM Connected Workflow Rules
List Contacts
List Contacts
ZOHO_LIST_CONTACTSRetrieves contact records from Zoho CRM with support for pagination, filtering, and sorting. Use this action when you need to fetch a list of contacts from Zoho CRM. This is a specialized action focused on the Contacts module with contact-specific field defaults and optimizations. For retrieving records from other modules, use the generic get_records action instead.Input Parameters
Output
List Deals
List Deals
ZOHO_LIST_DEALSRetrieves a list of deals from Zoho CRM with support for filtering, sorting, and pagination. Use this action when you need to fetch deal records from Zoho CRM, whether all deals or filtered by specific criteria. The action supports both discrete pagination (page/per_page) for the first 2,000 deals and token-based pagination for larger datasets.Input Parameters
Output
List Zoho CRM Events
List Zoho CRM Events
ZOHO_LIST_EVENTSLists Zoho CRM Events (displayed as Meetings in the UI), with pagination and filtering. Page-based pagination is limited to the first 2,000 records; use the previous response’s info.next_page_token for token-based pagination beyond that limit.Input Parameters
Output
List Zoho CRM Functions
List Zoho CRM Functions
ZOHO_LIST_FUNCTIONSList configured Zoho CRM functions and their metadata.Input Parameters
Output
List Zoho CRM Leads
List Zoho CRM Leads
ZOHO_LIST_LEADSRetrieves lead records from Zoho CRM’s Leads module with pagination support. Use this action when you need to list, filter, or paginate through leads in the CRM. Supports both discrete pagination (up to 2,000 leads) and token-based pagination for larger datasets.Input Parameters
Output
List Zoho CRM Modules
List Zoho CRM Modules
ZOHO_LIST_MODULESLists all available Zoho CRM modules (standard + custom) to reliably select module API names/IDs for operations. Use this tool before calling other module-specific operations to ensure correct module_api_name selection and avoid INVALID_MODULE errors. Particularly useful for discovering custom modules and their exact API names.Input Parameters
Output
List Zoho CRM Notes
List Zoho CRM Notes
ZOHO_LIST_NOTESRetrieves one paginated list of notes across all Zoho CRM modules, with fields selected by the caller; notes are returned in chronological order (oldest first by default). Zoho restricts this organization-wide GET /Notes endpoint to users with an admin profile.Input Parameters
Output
List Attachments for Zoho CRM Record
List Attachments for Zoho CRM Record
ZOHO_LIST_RECORD_ATTACHMENTSTool to list attachment metadata (id, File_Name, Size, Created_Time, etc.) for a specific Zoho CRM record. Use when you need to identify attachments before downloading them via other means. This returns metadata only, not the actual file content.Input Parameters
Output
List Zoho CRM Tasks
List Zoho CRM Tasks
ZOHO_LIST_TASKSRetrieves tasks from the Tasks module in Zoho CRM with support for filtering, pagination, and sorting. Use this action when you need to fetch a page of tasks or specific tasks by IDs. Supports both discrete pagination (up to 2,000 tasks) and token-based pagination for larger datasets. Notes: - Discrete (page/per_page) pagination is limited to the first 2,000 tasks. To retrieve tasks beyond this, use token-based pagination via page_token from the previous response’s info.next_page_token. - Do not use page together with page_token. - You cannot use cvid together with sort_by.Input Parameters
Output
List Zoho CRM Variables
List Zoho CRM Variables
List Zoho CRM Workflow Rules
List Zoho CRM Workflow Rules
ZOHO_LIST_WORKFLOW_RULESList and filter workflow rules configured in Zoho CRM.Input Parameters
Output
Merge Zoho CRM Leads
Merge Zoho CRM Leads
Search Zoho CRM Accounts
Search Zoho CRM Accounts
ZOHO_SEARCH_ACCOUNTSSearch for Account records within Zoho CRM using server-side queries. Returns a paginated page of accounts matching the specified criteria, phone, or keyword, up to the API’s 2,000-record search limit.Input Parameters
Output
Search Zoho CRM Calls
Search Zoho CRM Calls
ZOHO_SEARCH_CALLSSearch for Call records in Zoho CRM using server-side queries. Returns calls matching the specified criteria or keyword. Use this action to retrieve a paginated page of matching Call records, up to the API’s 2,000-record search limit.Input Parameters
Output
Search Zoho CRM Contacts
Search Zoho CRM Contacts
ZOHO_SEARCH_CONTACTSSearch for contacts in Zoho CRM using server-side queries by criteria, email, phone, or keyword. Use this action to find specific contacts instead of listing all contacts.Input Parameters
Output
Search Deals in Zoho CRM
Search Deals in Zoho CRM
ZOHO_SEARCH_DEALSSearch for Deal records in Zoho CRM using server-side queries. Returns a paginated page of matching deals, up to the API’s 2,000-record search limit.Input Parameters
Output
Search Events
Search Events
ZOHO_SEARCH_EVENTSSearch for Events in Zoho CRM using server-side queries. Returns a paginated page of events matching field criteria or keyword, up to the API’s 2,000-record search limit.Input Parameters
Output
Search Leads
Search Leads
ZOHO_SEARCH_LEADSSearch for lead records in Zoho CRM using server-side queries. Returns a paginated page of matching leads, up to the API’s 2,000-record search limit.Input Parameters
Output
Search Notes
Search Notes
ZOHO_SEARCH_NOTESSearch for notes in Zoho CRM using server-side queries. Returns a paginated page of matching notes, up to the API’s 2,000-record search limit.Input Parameters
Output
Search Zoho CRM Tasks
Search Zoho CRM Tasks
ZOHO_SEARCH_TASKSSearch for tasks in Zoho CRM using flexible criteria. Returns a paginated page of matching tasks, up to the API’s 2,000-record search limit.Input Parameters
Output
Search Zoho CRM Records
Search Zoho CRM Records
ZOHO_SEARCH_ZOHO_RECORDSSearch for records within a Zoho CRM module using server-side queries. Use when you need to find specific records by criteria, email, phone, or keyword. Results are paginated at up to 200 records per page and limited to 2,000 records per search.Input Parameters
Output
Update Zoho CRM Account
Update Zoho CRM Account
ZOHO_UPDATE_ACCOUNTUpdates an existing Account record in Zoho CRM with the specified field values. Only the fields provided in the request will be updated; other fields remain unchanged. Use this action when you need to modify specific details of an existing account, such as contact information, address, ownership, or business details. All field updates use API field names (not display labels), and lookup fields require properly formatted dictionaries with ‘id’ keys.Input Parameters
Output
Update Zoho CRM Call
Update Zoho CRM Call
ZOHO_UPDATE_CALLUpdates existing call records in the Calls module in Zoho CRM. Supports updating up to 100 call records per API call. Use this action when you need to modify call details such as call duration, call type, subject, or related contacts/leads. Use field API names (not display names) for all field updates. The ‘id’ field is mandatory for each call record. Note: For Inbound or Outbound calls, the Call_Duration must be non-zero or the API will return a DEPENDENT_MISMATCH error.Input Parameters
Output
Update Zoho CRM Custom Fields
Update Zoho CRM Custom Fields
ZOHO_UPDATE_CUSTOM_FIELDSUpdate custom-field definitions; some changes can alter existing record values.Input Parameters
Output
Update Zoho CRM Custom View
Update Zoho CRM Custom View
ZOHO_UPDATE_CUSTOM_VIEWUpdate the configuration of one Zoho CRM custom view.Input Parameters
Output
Update Zoho CRM Deal
Update Zoho CRM Deal
ZOHO_UPDATE_DEALUpdates an existing deal in Zoho CRM. Use this action when you need to modify specific fields of a deal record, such as updating the deal amount, stage, closing date, or associated account. Only the fields included in the data parameter will be modified; other fields remain unchanged. Use when you have a specific deal ID and want to update one or more fields without affecting others.Input Parameters
Output
Update Zoho CRM Email Draft
Update Zoho CRM Email Draft
ZOHO_UPDATE_EMAIL_DRAFTUpdates an existing email draft associated with a record in Zoho CRM. Requires the draft ID, sender address, and text format. Use this action when you need to modify the recipients, subject, content, scheduling, or attachments of an existing email draft before sending. Supports updating up to 100 email drafts per API call. Schedule times must be in the future.Input Parameters
Output
Update Zoho CRM Event
Update Zoho CRM Event
ZOHO_UPDATE_EVENTUpdates existing events in Zoho CRM. Supports updating up to 100 events per API call. Use this action when you need to modify event details such as title, start/end times, location, participants, or related records (What_Id/Who_Id). The ‘id’ field is mandatory for each event, and only specified fields will be updated.Input Parameters
Output
Update Zoho CRM Layout
Update Zoho CRM Layout
Update Lead
Update Lead
ZOHO_UPDATE_LEADUpdates existing lead records in Zoho CRM. Supports updating up to 100 leads per API call. Use this action when you need to modify lead information such as contact details, lead status, lead source, or other lead-specific fields. Use field API names (not display names) for all field updates. The ‘id’ field is mandatory for each lead.Input Parameters
Output
Update Zoho CRM Note
Update Zoho CRM Note
ZOHO_UPDATE_NOTEUpdates an existing Zoho CRM note by ID, including its title, content, or portal-user sharing setting.Input Parameters
Output
Update Zoho CRM User
Update Zoho CRM User
Update Zoho CRM Webform
Update Zoho CRM Webform
Update Zoho CRM Workflow Rule
Update Zoho CRM Workflow Rule
Update Zoho CRM Record
Update Zoho CRM Record
ZOHO_UPDATE_ZOHO_RECORDUpdates up to 100 existing records in a specified Zoho CRM module using field API names and an ID for each record. A batch can partially succeed even when the tool reports an error.Input Parameters
Output
Upload Attachment to Zoho CRM Record
Upload Attachment to Zoho CRM Record
ZOHO_UPLOAD_ATTACHMENTTool to upload a file as an Attachment to a specific Zoho CRM record. Use when you need to store files (PDFs, documents, images) in a record’s Attachments section.Input Parameters
Output
Upload Zoho CRM Record Photo
Upload Zoho CRM Record Photo
ZOHO_UPLOAD_RECORD_PHOTOSet or replace the photo on a supported Zoho CRM record.Input Parameters
Output
Upsert Zoho CRM Records
Upsert Zoho CRM Records
ZOHO_UPSERT_RECORDSInsert or update up to 100 records using Zoho CRM duplicate matching.Input Parameters
Output
Validate Zoho CRM Credentials
Validate Zoho CRM Credentials
ZOHO_VALIDATE_CREDENTIALValidates Zoho CRM credentials by retrieving current user information. Returns user details if credentials are valid. Use this action when you need to verify that API credentials are working correctly before performing other operations. This is a read-only operation that confirms authentication without modifying any data.