Add Zoho to your AI agent

Deletes 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.

Deletes a contact from Zoho CRM. This action is irreversible — the contact cannot be recovered once deleted. Use this action when you need to permanently remove a contact record from the CRM. All associated subforms and related data are automatically deleted.

Delete one unsent email draft associated with a Zoho CRM record.

Move one Zoho CRM Event record to the recycle bin. Omitting wf_trigger uses Zoho's default of true, so workflows and notifications can run.

Move one Zoho CRM Lead record to the recycle bin.

Move one Zoho CRM note to the recycle bin.

Move up to 100 records from a Zoho CRM module to the recycle bin.

Delete one Zoho CRM tag definition by its tag ID.

Download one attachment from a Zoho CRM record as a file.

Download the binary profile photo attached to a supported CRM record.

Retrieves a specific Account record from Zoho CRM by its unique identifier. Returns complete account details including all standard and custom fields. Use this action when you need to fetch a single account's information by its ID rather than searching or listing multiple accounts. Unlike bulk record retrieval, this action provides access to subform records, multi-select lookup fields, and multi-user lookup fields that are only available in single-record responses.

Retrieve one assignment rule and its module-specific configuration.

Retrieve one configured Zoho CRM automation task and its field mappings.

Retrieve one Zoho CRM blueprint and optional configuration details.

Retrieves a single contact record by ID from Zoho CRM. Returns the complete contact details including owner information, account associations, address fields, and all custom fields. Use this action when you need to fetch detailed information about a specific contact using its record ID.

List custom views for a Zoho CRM module or inspect one view by ID.

Retrieve one Zoho CRM Deal by record ID without a field projection.

Retrieves a specific event record from Zoho CRM by its unique identifier. Returns complete event details including all standard and custom fields. Use this action when you need to fetch detailed information about a specific event/meeting, including participants, location, timing, and related records. The response includes subform data and multi-select lookup values that are not available in list queries.

Retrieves 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.

List a kiosk's states or retrieve one state and its associated elements.

List layouts for a CRM module or retrieve one complete layout definition.

Retrieves a single note by its unique identifier from Zoho CRM. Returns the note's title, content, parent record reference, owner details, and timestamps. Use this action when you need to fetch detailed information about a specific note, such as reading meeting notes, viewing customer interaction summaries, or accessing documentation attached to a CRM record.

Retrieve pipeline and stage configuration for a Zoho CRM Deals layout.

Retrieve one Zoho CRM Product by record ID.

Retrieve one Zoho CRM permission profile and its expanded permissions.

Retrieve 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.

Retrieve one email associated with a Zoho CRM record, including its body.

Retrieves 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.

Retrieve chronological field and related-record history for a Zoho CRM record.

Retrieves related list metadata for a Zoho CRM module to discover correct api_name values. Use this before updating related records to avoid INVALID_DATA errors from incorrect related_list_api_name. Returns api_name, display_label, href, and other details for each related list available in the module.

Fetch related-list records (e.g., Notes, Attachments, Emails) for a Zoho CRM parent record using related_list_api_name. Use ZOHO_GET_RELATED_LISTS first to discover the correct api_name for the related list you want to access. Supports pagination for large result sets (up to 2,000 records with page/per_page and up to Zoho's token-pagination limit with page_token).

Retrieves a specific task record by its ID from Zoho CRM. Returns complete task data including all standard and custom fields, subforms, and multi-user lookup fields that are only available when fetching individual records. Use this action when you need to fetch detailed information about a single task using its unique record ID.

Retrieves 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.

Retrieve one configured Zoho CRM webform by ID.

Retrieve one Zoho CRM workflow rule and its complete configuration.

Tool 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.

List roles or permission profiles configured in Zoho CRM.

Retrieves 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.

List Zoho CRM cadence definitions using optional filters.

Retrieves 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.

List trigger conditions for a module's rules in a connected workflow.

Retrieves 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.

Retrieves 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.

Lists events (meetings) from Zoho CRM with pagination and filtering support. Use this action when you need to retrieve scheduled events, meetings, or appointments from Zoho CRM for calendar management, reporting, or synchronization purposes. Note: In Zoho CRM UI, Events are displayed as 'Meetings'. Discrete pagination (page/per_page) is limited to the first 2,000 records. To retrieve events beyond this limit, use token-based pagination via page_token from the previous response's info.next_page_token.

List configured Zoho CRM functions and their metadata.

Retrieves 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.

Lists 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.

Retrieves one paginated list of notes from Zoho CRM across all modules. Notes are returned in chronological order (oldest first by default). Zoho restricts this organization-wide GET /Notes endpoint to users with an admin profile. Use this action when you need to browse notes in the CRM regardless of which record they're attached to. Each note includes its title, content, creator, timestamps, and parent record reference.

Tool 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.

List the tags available for a Zoho CRM module.

Retrieves 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.

List Zoho CRM configuration variables and their current values.

List and filter workflow rules configured in Zoho CRM.

Merge duplicate leads into a retained master lead and delete the child leads.

Search 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.

Search 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.

Search for contacts in Zoho CRM using server-side queries by criteria, email, phone, or keyword. This action performs efficient server-side filtering in the Contacts module, avoiding pagination limits. Use this action when you need to find specific contacts instead of listing all contacts.

Search 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.

Search 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.

Search 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.

Search 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.

Search 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.

Search 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.

Updates 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.

Update custom-field definitions; some changes can alter existing record values.

Update the configuration of one Zoho CRM custom view.

Updates 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.

Updates 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.

Updates 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.

Update a custom layout's metadata, profile access, sections, or fields.

Updates 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.

Update a Zoho CRM user's name, email, contact details, locale, time preferences, role, profile, or status by ID.

Replace one Zoho CRM webform configuration using the V8 path-ID route.

Update a Zoho CRM workflow rule's name, description, or activation status by ID.

Tool 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.

Set or replace the photo on a supported Zoho CRM record.

Insert or update up to 100 records using Zoho CRM duplicate matching.

Validates 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.

Converts a lead into a contact, account, and optionally a deal in Zoho CRM.

Creates new records in a specified module in Zoho CRM. Bulk operations may partially succeed — inspect each item's status field in the response, as some records may be created while others fail.

Creates 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.

Deletes 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.

Retrieves 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.

Retrieves 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.

Retrieves 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.

Retrieves 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.

Updates 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.

Updates an existing note in Zoho CRM. Only the Note_Title and Note_Content fields can be modified. Read-only fields (Owner, Modified_Time, Created_Time, Modified_By, Created_By) cannot be updated and will be ignored if provided. Use this action when you need to modify the title or content of an existing note attached to any CRM record.

Associates or updates relationships between records across different modules in Zoho CRM. This action creates or modifies relationships between a parent record and related records. Common use cases: - Associate Leads/Contacts with Campaigns (with member status) - Link Products to Deals/Quotes/Accounts - Connect Contacts to Accounts - Associate Services with Appointments Use ZOHO_GET_RELATED_LISTS to discover valid related_list_api_name values for your module. Maximum 100 related records can be updated per API call. If module_api_name, record_id, related_list_api_name, or child record IDs in data do not match Zoho CRM's related-list configuration exactly, associations may silently succeed (no error returned) but the relationship will not be created.

Updates existing records in a specified module in Zoho CRM. Supports updating up to 100 records per API call. Use field API names (not display names) for all field updates. The 'id' field is mandatory for each record.