Kaizen 216 - Actions APIs : Email Notifications
Welcome to another week of Kaizen!
For the last three weeks, we have been discussing Zylker's workflows. We successfully updated a dormant workflow, built a new one from the ground up and more. But our work is not finished—these automated processes are operating in a vacuum.
What happens when a high-value deal is finally flagged, or a new social media post is published? How does the team know to take the next crucial step? How does the system connect with your team? Through Automatic Actions-the vital link between automation and people.
The actions include:
- sending email notifications
- assigning tasks to users
- updating fields
- communicating with third-party applications by sending instant web notifications, etc.
In this post we will focus on Email Notifications.
After bringing structure and visibility to workflows using the custom admin dashboard, the system administrators at Zylker seek to include Workflow Actions so that details of the actions associated with each workflow can be managed from the dashboard itself. Including Email Notification details to Zylker's dashboard ensure the right people receive clear, actionable email alerts at the perfect moment.
This update to the dashboard will allow system admins to:
- audit the existing email notifications,
- create new email notifications,
- update existing email notifications, and
- clean up inactive and unwanted email notifications.
STEP 1: Discover and audit existing email notifications
To get details of email notifications in the system the admins use GET email notifications API. This gives us the required information about email notifications in the system.
Request URL:
GET {api-domain}/crm/v8/settings/automation/email_notifications
Response JSON:
{ "email_notifications": [ { "template": { "name": "VP Alert - High Value Deal", "id": "6660682000001292005" }, "reply_to_address": { "resource": { "id": "5843104000000424686" }, "type": "user" }, "created_time": "2025-02-26T14:35:51+05:30", "lock_status": { "locked": false }, "editable": true, "module": { "api_name": "Deals", "id": "6660682000000002181" }, "related_module": null, "deletable": true, "recipient_count": "3", "source": "crm", "created_by": { "name": "Alex Rivera", "id": "6660682000000501002" }, "feature_type": "workflow", "modified_time": "2025-07-06T16:15:58+05:30", "associated": true, "name": "VP Alert - High Value Deal", "modified_by": { "name": "Alex Rivera", "id": "6660682000000501002" }, "id": "6660682000000000353", "from_address": { "resource": { "id": "5843104000000424686" }, "type": "user" } }, //more records omitted for brevity ], "info": { "per_page": 200, "count": 2, "page": 1, "more_records": false } } |
STEP 2: Create new email notifications
The admin seeks to create a new email notification when a deal is lost. For creating the email notification first the admin should create an email template in Zoho CRM.
Lost Deal Email TemplateFor creating an email notification, admin uses Create Email Notification API.
Request URL:
POST {api-domain}/crm/v8/settings/automation/email_notifications
Input JSON:
{ "email_notifications": [ { "template": { "name": "Lost Deal", "id": "5843104000006629014" }, "module": { "api_name": "Deals", "id": "5843104000000002181" }, "related_module": null, "feature_type": "workflow", "bulk_email": false, "recipients": { "to": [ { "details": { "api_name": "${!Deals.Owner}", "id": "5843104000000002555" }, "type": "merge_field" }, { "details": { "api_name": "${!Deals.Owner.Reporting_To}", "id": "5843104000000256015" }, "type": "merge_field" }, { "resource": { "name": "Patricia Boyle", "id": "5843104000000424672" }, "type": "user" } ] }, "name": "LostDealNotification" } ] } |
Response:
{ "email_notifications": [ { "code": "SUCCESS", "details": { "id": "5843104000006646001" }, "message": "alert created successfully", "status": "success" } ] } |
Key Fields:
1. Basic Fields
- name: A unique identifier for your notification (e.g., "LostDealNotification")
- feature_type: Set to "workflow" for automation-triggered notifications from workflow.
- template: The ID and name of the email template you created earlier
- module: The ID and API_name of the module this email notification applies to.
- bulk_email: bulk_email field indicates whether the email notification will be sent a single mass email with all recipients displayed. When this key is set as true, you can add recipients in CC and BCC
2. Recipients
The recipients object determines who receives the notification. The possible recipients to an email notification are indicated by the to, cc and bcc keys. These type field inside these keys indicate the type of recipient, with possible values including merge_field, group, role, role_and_subordinate, territory, territory_and_subterritory, emails, user (applicable for team modules), and profile (applicable for team modules).
You can use three main strategies to add recipients:
- A. Dynamic Fields (Merge Fields)
Use "type": "merge_field" to dynamically pull email addresses from the record:
{ "type": "merge_field", "details": { "api_name": "${!Deals.Owner}" // Sends to the deal owner } } |
- B. Specific Users or Groups or Roles or Territories
Use these options to send notifications to specific people
{ "type": "user", "resource": { "id": "5843104000000424672" // Patricia Boyle's user ID } } |
- C. Direct Email Addresses
Use "type": "emails" for fixed email addresses:
{ "type": "emails", "details": { "emails": ["customer.success@zylker.com"] } } |
STEP 3: Updating an email notifications
Zylker noticed a troubling pattern in their sales analytics. They were experiencing a much higher deal loss rate compared to the same period last year. The management brought in Mark Stevens, a Sales Strategist who specializes in analyzing lost deals. His first request was simple: "I need to see every lost deal as it happens to spot patterns in real-time."
Rather than creating new work flow rules or actions, the admin simply updates the existing email notification for lost deals to include Mark.
Request URL to update the lost deal email notification:
POST {api-domain}/crm/v8/settings/automation/email_notifications/5843104000006646001
Input JSON:
{ "email_notifications": [ { "recipients": { "to": [ { "details": { "api_name": "${!Deals.Owner}", "id": "5843104000000002555" }, "type": "merge_field" }, { "details": { "api_name": "${!Deals.Owner.Reporting_To}", "id": "5843104000000256015" }, "type": "merge_field" }, { "resource": { "name": "Patricia Boyle", "id": "5843104000000424672" }, "type": "user" }, { "details": { }, "type": "emails" } ] } } ] } |
Response:
{ "email_notifications": [ { "code": "SUCCESS", "details": { "id": "5843104000006646001" }, "message": "alert updated successfully", "status": "success" } ] } |
After analyzing two weeks of lost deal notifications, Mark identified a pattern in the lost deals: over 80 percent of the recent losses were concentrated in the one industry - healthcare. He found that healthcare prospects consistently raised concerns about HIPAA compliance and data security protocols and that Zylker's sales team were not addressing them effectively. He made suggestions to train the sales team so that they can confidently address these specific requests.
STEP 4: Deleting email notifications
Any unwanted or redundant email notification can be deleted using Delete Email Notifications API.
Request URL to delete an email notification:
DELETE {api-domain}/crm/v8/settings/automation/email_notifications/5843104000006645001
Request URL to delete multiple email notifications:
DELETE {api-domain}/crm/v8/settings/automation/email_notifications?ids=5843104000006645001,5843104000006645002
However, notifying alone is not sufficient. It should be followed with actionable tasks. In the next post, we will explore Workflow Tasks APIs.
We hope that you find this post on Actions - Email Notifications APIs useful. If you have any feedback, or if there are any pain-points that you would like us to address in our Kaizen series, please let us know in the comments, or reach out to us via support@zohocrm.com.
Topic Participants
Mable Mary M P
Sticky Posts
Announcing the new SKILL.md for Zoho CRM and the updated OAS repository!
We are introducing a new zoho-crm skill to make working with Zoho CRM Developer tools (like APIs, functions, widgets, client scripts, queries etc) easier and faster, with the help of AI in your preferred AI harness like Claude Code, Codex, Cursor, VSCodeKaizen #261 : Using Zoho CRM Skill to generate complex COQL queries
Hello everyone, In the previous Kaizen posts, we introduced the zoho-crm SKILL.md and discussed how it can help you when you are working with Zoho CRM APIs and Client Script. In this Kaizen, we will focus on using the Zoho CRM `SKILL.md` with GitHub CopilotKaizen #256 - Build an Arrival Readiness Web Tab in Zoho CRM
Hi everyone! Welcome back to the Kaizen series! In the post, we discuss a use case in hospitality industry: how an Arrival Readiness web tab widget can be used to let reception staff identify and resolve issues before arrival of guests. Use case In theKaizen #198: Using Client Script for Custom Validation in Blueprint
Nearing 200th Kaizen Post – 1 More to the Big Two-Oh-Oh! Do you have any questions, suggestions, or topics you would like us to cover in future posts? Your insights and suggestions help us shape future content and make this series better for everyone.Kaizen #226: Using ZRC in Client Script
Hello everyone! Welcome to another week of Kaizen. In today's post, lets see what is ZRC (Zoho Request Client) and how we can use ZRC methods in Client Script to get inputs from a Salesperson and update the Lead status with a single button click. In this
Recent Topics
Address limits per customer by edition
I’m on the Standard edition and have reached a limit of 30 addresses under a single customer. Before I move to an annual Professional subscription, I need to confirm the following: What is the maximum number of addresses allowed under one contact, andZoho CRM and Desk sandboxes for testing native integration
Hello team, We are evaluating the native integration between Zoho CRM and Zoho Desk, We have sandbox instances of both products and want to test the integration there, without any effect on our production CRM or production Desk data. While setting upOption to Disable Knowledge Base Section in Feedback Widget Popup Hello Zoho Desk Team
Hello Zoho Desk Team, How are you? We are actively using Zoho Desk and would like to make more use of the Feedback Widget. One of the ways we implement it is through the popup option. At the moment, the popup always displays the Knowledge Base section,Losing description after merging tickets
Hello, We merge tickets when they are about the same topic from the same client. It happens sometimes. We recently noticed that after the merger only the description from the master ticket is left in a thread. And the slave-ticket description is erased.Outgoing Mail Blocked – Suspicious Login Activity (Need Clarification and Solution)
Hello, I’m currently facing an issue where my Zoho Mail account has been blocked due to “suspicious login activity,” and outgoing emails are restricted. Here are the details shown: Block type: Outgoing mail blocked Reason: Suspicious login activity AAccount Blocked due to Suspicious Activity.
Hello, Trying to get access to my account, I have found this message above in the subject of this message. I am unable to log back to my account (see err. mess. below.) and thus cannot get rif of this following the Zoho procedure : I followed the stepZoho Recruit mailserver get blocked by Microsoft!
Hi, We have experienced this issue twice now, where Zoho Recruit outbound IP addresses are being blocked by Microsoft. We are confident that Microsoft is the blocking party, as all outbound emails to candidates with @hotmail.com, @live.com, and @outlook.comMonths of WooCommerce–Zoho Inventory sync failures and repeated support requests – has anyone experienced this?
Months of WooCommerce–Zoho Inventory sync failures and repeated support requests – has anyone experienced this? I run a small retail business using WooCommerce and Zoho One. For months, I have been trying to resolve recurring synchronisation failuresName autocomplete
Hi, During searching emails the web tool does not always propose the auto-completion of the saved emails. As a result I either have to go to contacts and look up the exact email, or the exact full name including the middle name and any dots, which isHow to Manage Two GST Numbers / Two Companies in a Single Zoho Inventory Organization?
Hi Team, We currently have two separate legal entities: A Proprietorship Firm with its own GSTIN A Private Limited Company with a different GSTIN However, operationally, both companies deal with the same products, and we would like to manage the physicalView Cannot Use UPC as Criteria
When creating a new custom view, the UPC field is not available as a criterion for the view. This seems strange, because both ISBN and EAN are available in the dropdown. Because of this, I feel like the situation is possibly an oversight rather than byHow To Implement an Auto-Check-out Feature for Attendance?
If an employee forgets to check out, the system should automatically check out the employee at 6:30 PMEnhanced Zoho CRM and Office 365 calendar synchronization features!
Dear customers, We're excited to share some significant improvements to our Office 365 calendar synchronization features, aimed at providing you with more control and a more personalized experience. What’s new Choose your Office 365 calendar: During theWhat are the best practices for managing tax records and financial information for a small business?
I’m interested in learning how other small business owners and accounting professionals organize their financial records and prepare for tax filing. With bookkeeping, expense tracking, income records, and tax documents all needing to stay accurate, havingHow to Open Google Takeout and Thunderbird MBOX Files?
MBOX files are used by email clients and services, such as Google Takeout and Mozilla Thunderbird, to store email messages. It can, however, be difficult to open such files if you don't have an email programme that is compatible. Google Takeout enablesConvert MBOX to PDF Free on Mac and Windows
MBOX files are widely used for storing email messages in email clients such as Thunderbird, Apple Mail, and other programs that support the MBOX format. Although this format is useful for handling emails, it can at times be inconvenient to access theHow to Convert Apple Mac Mail to PST for Outlook for Free?
Apple Mail is a widely used email program among Mac users, but what do you do if you want to transfer your emails to Microsoft Outlook? In such a situation—for example, when you are moving from a Mac to a Windows computer or when you need to use OutlookCannot apply tags to multiple items at once
It is very frustrating needing to apply tags to notes individually. Even worse that it takes multiple clicks to do it. Can there please be an update to: 1.) Allow us to apply tags to batches of notes in one go. 2.) Make it less clicks to add a tag 3.)Automating CRM backup storage?
Hi there, We've recently set up automatic backups for our Zoho CRM account. We were hoping that the backup functionality would not require any manual work on our end, but it seems that we are always required to download the backups ourselves, store them,not able to convert pdf to jpg and other forms and vice versa.
i want to change my pdf to jpg, word, etc and some times jpg to pdf. i don't know how to do in this.Changing an existing item to different accounts & inventory-tracked
Hi everyone, I have an item in Zoho Books that was originally set up as a non-inventory item. Over time, I associated it with different sales and purchase accounts, and I now have many invoices, bills, and reports that use this item. My business processHow to Convert Emails to PDF Format in Batch
It is helpful to convert emails into PDF format when you want to save important messages, when you need to share business correspondence, or when you wish to keep email records for future reference. PDF files can be readily opened, printed, and sharedFunction #24: Automatically display deal name from Zoho CRM on quotes in Zoho Books
Deals allow businesses to organize and visualize their sales pipeline. This provides a clear overview of all potential opportunities and helps in making informed decisions. Zoho CRM empowers you to create deals or potentials for your clients and monitorLookups and Custom Modules
I created a Custom Module that I'm calling "Item Purchasing Group". This module will store information for groups of Items that must be purchased together (including minimum overall quantities and/or values, etc.). This will have a one-to-many relationshipZoho Books | Product updates | October 2026
Hello users, October brings a range of new features and enhancements to Zoho Books, designed to simplify compliance, streamline accounting workflows, and improve inventory management. From the launch of the Nigeria Edition and France’s e-invoicing capabilitiesCreate custom rollup summary fields in Zoho CRM
Hello everyone, In Zoho CRM, rollup summary fields have been essential tools for summarizing data across related records and enabling users to gain quick insights without having to jump across modules. Previously, only predefined summary functions wereButton or Links order
Is there a way to re-order the buttons or links that are created? Moderation Update: With our recent enhancement to custom button creation from the layout editor, administrators can now reorder custom buttons directly from the layout editor, and thisZoho Books | Product updates | August 2026
Hello users, July has been an exciting month for Zoho Books! This month, we're excited to introduce HTML PDF Templates, Placeholders as Pills, expanded approval workflows for Sales Returns and Journals, and significant compliance updates across the India,Bulk updating tags
My organisation handles a number of restricted funds. We previously did this by having a chart of accounts where each restricted fund has its own income and expense accounts. However, our accountant changed this, moving all transactions into accountsDownload or Backup Bulk Emails from IMAP Server
Taking email messages from an IMAP server and saving them is a wise method for ensuring that important emails are kept safe and easy to access. No matter whether you have a business email address or a personal mailbox, keeping a local copy of your emailsZoho Writer Label Template Merge/Print Via API/Webhook/Flow
Short version of goal: To be able to kick off a Zoho Writer Label Template Document via API or Webhook or even using Zoho Flow. As of right now I have been unable to figure out a way to do that. Long version of goal: We would like to press a button (runKaizen #263: Using Zoho CRM Skill to Build Widgets
Hello everyone! Welcome back to another exciting Kaizen post. In the previous Kaizen posts, we introduced the zoho-crm skill.md and explored how it can help with Zoho CRM APIs, Client Scripts, complex COQL queries, and Skill to build Queries. In thisZoho notebook No login
Hello Team, I recently downloaded and installed the latest version of zoho notebook for windows. But I am not able to login without providing any sso or email address. Did you removed the no login feature for this app? This is just a windows app. canSearch is completely broken for PC
I go to note, try to search for "mtga" and it shows 702 results (it's a big note), highlights all letters "m" and I can't find anything. Same for "gathering" - it thinkgs I think only for "g". Looking for "zoho" shows as if I searched only for "z". UsingBehind a great customer experience is a team
Hi everyone, October is here, and the first week marks the Customer service week. Each year, we thank our customer service professionals. Service professionals are all around us, even in our own workplaces: They handle essential administrative work likeWhat's New - August and September 2026 | Zoho Backstage
Hello everyone, August and September bring a fresh wave of intelligence to Zoho Backstage. AI takes the spotlight with tools that help you create content, support attendees, and manage how AI fits into your events. Alongside AI, we’ve refined email communication,Images Not Displaying Properly in Zoho Desk
Hi, We are experiencing an issue with image rendering in Zoho Desk, affecting both incoming and outgoing emails. Images embedded in email conversations are not displaying properly. Instead, we see broken image icons or empty placeholders where the imagesAnnouncing the new SKILL.md for Zoho CRM and the updated OAS repository!
We are introducing a new zoho-crm skill to make working with Zoho CRM Developer tools (like APIs, functions, widgets, client scripts, queries etc) easier and faster, with the help of AI in your preferred AI harness like Claude Code, Codex, Cursor, VSCodeWidget Height were destroyed
All widget heights in the Details Canvas view are broken. Moderation Update: This is a known issue with widget heights in Client Script popups and flyouts. A fix is in progress, and this post will be updated once it's released.Zoho Projects - Has something changed regarding to linking Projects and Deals via the API?
I am trying to link Zoho Projects to Deals in CRM using the API, but each time, the Deal Contact is added as a Client user and receives an email invite asking them to join the organisation. These are internal projects and the customer should not haveNext Page