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
Kaizen #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 thisKaizen #222 - Client Script Support for Notes Related List
Hello everyone! Welcome to another week of Kaizen. The final Kaizen post of the year 2025 is here! With the new Client Script support for the Notes Related List, you can validate, enrich, and manage notes across modules. In this post, we’ll explore howKaizen #217 - Actions APIs : Tasks
Welcome to another week of Kaizen! In last week's post we discussed Email Notifications APIs which act as the link between your Workflow automations and you. We have discussed how Zylker Cloud Services uses Email Notifications API in their custom dashboard.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
Recent Topics
How do I set the value of a Lookup field in SlyteUI?
I am using the "crm-field" component in a SlyteUI project (code attached) https://www.zohocrm.dev/explore/slyteui/ui-components/crm-field/api#Properties The client would like to have this field pre-populated with a value. When I try to input the recordMise à jour de Zoho Books – France
Chers clients, Merci pour votre patience et votre soutien continu. Avec les évolutions réglementaires à venir en France nous introduisons de nouvelles fonctionnalités dans Zoho Books pour les clients français. Ces mises à jour ont été conçues pour répondreCRM Developer Update: Mandatory field behavior changes in Zoho CRM APIs
We are planning a few updates to Zoho CRM APIs that are expected to be rolled out by the end of October 2026. These changes are not live yet. We are sharing this early so developers and partners can review the impact and prepare in advance. What is changing?Show Available Stock as a Column in Item Views (Including by Warehouse)
It would be very useful to have Available Stock as a standard column in the Items list view. Currently Stock On Hand does not show the real picture for businesses managing orders and inventory. Example: Stock on Hand: 100 Committed to Sales Orders: 80What's New in Zoho POS - July 2026
Hello everyone, Welcome to Zoho POS’s monthly update, where we share our latest feature updates, enhancements, events, and more. Let’s take a look at how July went. Support for Saudi's ZATCA Phase 2 e-invoicing We have added support for ZATCA (Zakat,How to make Contact a Help Center User
I see a "IsPortalUser" checkbox on each of the Customer account, but I am unable to check the checkbox. How is this configured?Introducing the new Fields API
Hello everyone, Greetings from Zoho Desk's API corner! With the rising need for integrations to connect multiple tools in businesses, APIs need to be adaptive, reliable, consistent, and ready for dynamic operations. To support better performance, efficiency,Service locations are tied to contacts?
Trying the system out. And what I discovered is that it seems that the whole logic of the app is, I'd say, backwards. There is a Customer - a company. The company has contact persons and service locations can be associated with different contact persons.Zoho ResearchStudio Shutdown Notice
Hi ResearchStudio fam, We are writing to inform you that Zoho ResearchStudio will be discontinued from Oct 5, 2026. Thank you for being a part of our journey and for trusting us with your qualitative research work. What this means for your data: YourSlideShare Downloader PDF not syncing in Zoho WorkDrive
Hi everyone, I use SlideShare Downloader for save study PPT and PDF files. After download I upload files in Zoho WorkDrive, but sometimes PDF preview not showing or sync take very long time. Small files work okay but some bigger presentation files haveメモの保存場所、見直しませんか？― Zoho Notebookで始める情報管理
ユーザーの皆様、こんにちは。ゾーホージャパンの朝香です。 AIを利用した業務が広がる中、AIによる情報漏洩対策を進めている組織も多いのではないでしょうか。 一方で、日常的に使っているメモの管理については、対策できていますか？ 業務中のメモには、重要な情報が含まれていることがあります。 そのため、AIへの入力だけでなく、メモの保存先についても是非確認をおすすめしたいと思います。 そこで今回は、使いやすさだけでなく、セキュリティにも配慮して設計されたZohoのノートアプリ「Zoho Notebook」をご紹介します！Zoho Sheet offline is now live on iPhone
Hello everyone, We've just rolled out offline support for Zoho Sheet on iOS—you can now create, edit, and analyze spreadsheets on your iPhone without an internet connection. Offline support has been a sustained priority for us. We're on the verge of bringingYou can now sync records from Custom Modules in Zoho CRM
p.MsoNormal, li.MsoNormal, div.MsoNormal { margin: 0.0cm; font-size: 12.0pt; font-family: Cambria; } p.MsoListParagraph, li.MsoListParagraph, div.MsoListParagraph { margin-top: 0.0cm; margin-right: 0.0cm; margin-bottom: 0.0cm; margin-left: 36.0pt; font-size: 12.0pt; font-family: Cambria; } p.MsoListParagraphCxSpFirst, li.MsoListParagraphCxSpFirst, div.MsoListParagraphCxSpFirst { margin-top: 0.0cm; margin-right: 0.0cm; margin-bottom: 0.0cm; margin-left: 36.0pt; font-size: 12.0pt; font-family: Cambria;Zoho ERP | Product updates | July 2026
Hello users, We're back with another round of updates to help you streamline your operations. This month's release brings new features and enhancements designed to help you work more efficiently. Read on to discover everything that's new in Zoho ERP thisFixed cost per task
Is there any way to assign a fixed cost per task, but track time for internal reporting? Don't see a way to do this currently.Set custom date creation for ticket using API in Desk
Hi. all.. I want know if is possible to add ticket with custom creation date via API... This would to be great because we are moving from another platform to Zoho and we have need to keep all statistics for old tickets also. In api docs i didnt see nothing about custom date in ticket creation but i would prefer a confirm from comunity/support. Thank you P.S.: Sorry for bad english languageAllow Shopify / marketplace orders to be cloned
Many businesses now use Shopify as a B2B ordering portal, not just a D2C ecommerce website. For B2B businesses, once these orders are imported into Zoho Inventory, Zoho often becomes the main system used to manage purchasing, stock, fulfilment and customerHow to Display a Logo Image on a Public Form?
I would like to display a logo image in the header of a form. To achieve this, I added an Add Notes field to the form. The code below works perfectly for Zoho users accessing the form. However, when the form is made public, the image does not load properly:Possible to define default font and size in Zoho Campaigns?
Is it possible to define a default font (font, size and colour) for the text, H1 and H2 in Zoho Campaigns? For example: In a campaign, I add a text block, and the text is automatically century gothic, size 11, grey (6f6f6e) by default? Thank you!Set Custom Colurs/Fonts/Style
I know I can save blocks as books marks but it would be nice to be able to define a custom colour pallet, the style of the H1, H2 etc to save me having to copy a previous block and set them manually over and over again. Since the colour picker doesn'tZoho CRM - Kiosk Studio: Build Once, Execute Multiple Times with Loops
Hello Everyone, Introducing Loop Functionality in Kiosk Studio. If you've ever built a Kiosk that needed to perform the same action multiple times like updating a list of contacts, scheduling calls for a batch of leads, or processing multiple productsSwitching from Notebook to another product, too unreliable
Not only is the spell check worse than useless, now there is a lag AFTER EVERY KEYSTROKE! This makes it impossible to use when there are innumerable products which provide this basic function. I made the mistake of relying on Notebook and have so manyAccidentally deleted a meeting recording -- can it be recovered?
Hi, I accidentally deleted the recording for a meeting I had today. Is there a way I can recover it?Zoho Desk: A Estruturação do Atendimento ao Cliente na era da IA
O mercado de atendimento ao cliente vem passando por uma transformação que não é apenas tecnológica, é também comportamental. As empresas que antes mediam qualidade de suporte pelo tempo de resposta, hoje precisam medir pela experiência completa, unindoAPI bookings/v1/json/appointment not adding additional fields he is returning this "customer_more_info": {"booking_form_type": "service"}
Hi, I'm trying to add additional fields inside zoho booking appointment api and I'm passing same data as you told inside your documentation. He is returning following response "customer_more_info": { "booking_form_type": "service" } I'm using this parameterBasic report- open sales order by item, with filter for customer ..
HI, we really need a basic report that sorts all open sales orders by Item, so you can see which items in your inventory are awaiting invoicing. Then you need a filter by customer, so you can see all the items a particular customer is waiting for. daily,Record sharing for Activities modules in CRM
Hello everyone, We've got a few quick enhancements to what we covered in this previous announcement: record sharing is now available for Activities modules. 1. Sharing Tasks, Meetings, and Calls Until now, activity records could only be shared indirectlyStock Count
The stock count is a nice new feature, but we cannot figure out how to: 1. Use it without assigning to a person, we have a team or one of multiple do stock counts as do most any company. 2. Add any extra fields to what the "counter" sees. The most importantAction Required: Update your TLS configuration to ensure uninterrupted access to Zoho WorkDrive
Hi everyone, To further strengthen the security of Zoho WorkDrive, we’re updating the TLS cipher suites supported across our services. As part of this change, older and less secure cipher suites are being phased out. If your browser, API client, desktopFree webinar: Zoho Sign in Q2 2026 - A quick walkthrough
Hi there, The second quarter of 2026 has flown by, and the Zoho Sign team has been hard at work releasing features to enhance how you send, sign, and manage documents. Join us for our upcoming webinar, where we'll discuss what's new and what's to come.Kiosk Studio + Zia Agents: Automate renewal risk classification in your CRM | Kiosk Studio Session #10
Renewal management is vital in a recurring revenue business. Your CRM already knows which accounts are at risk; the signals are present in contact titles, deal stages, call logs, account descriptions, and so on. What's missing is something that readsHow to Prefill Data in an Additional Form Submission from the First Form Submission
We need to prefill data in the second form submission based on the previously submitted form (when using the "Add Another Response" option). We have a form which allows customers to send us files via upload. It requires them to provide name, company name,Enable Credit Note creation for Sales Returns BEFORE receiving goods
Currently, it is not possible to issue a Credit Note linked to a Sales Return until the goods have been officially marked as "received" in the system. In our business, we often need to issue a credit note to our clients immediately upon the initiationRequest to Make Billing Company and Service Company Fields Editable.
Hello Latha, We noticed that once a Request, Estimate, or Work Order is created, we are unable to edit the Billing Company and Service Company details, as these fields become non-editable. Could you please make these fields editable after record creation?Client Script | Update - Client Script Support For Custom Buttons
Hello everyone! We are excited to announce one of the most requested features - Client Script support for Custom Buttons. This enhancement lets you run custom logic on button actions, giving you greater flexibility and control over your user interactions.Why associate tickets are just one direction?
When I associated the ticket #A with #B, in ticket #A I can see that exists another ticket associated. However, when I go to ticket #B, there is no reference that ticket #A is associated to #B. Is there a reason for that? Because it is confused and hardPhysical Batch Stock by Warehouse
We have activated batch tracking in Zoho Inventory. To reconcile our inventory with the physical stock reported by our 3PL, we need a report showing the total physical quantity still present in each warehouse, broken down by batch. This quantity is theNo "Import Users" option in Zoho FSM
I recently noticed that there is no option to import Users into Zoho FSM, and this has become a serious challenge for us. When migrating data, especially technicians or other user profiles, we often have hundreds of users to bring into the system. Currently,Elevate your Radar experience: Best practices part 2
In the Spotlight: Zoho Desk's Radar app Hello Everyone, In part 1 of Zoho Desk’s Radar app best practices, we explored role-based permissions, exceptions handling for critical alerts, daily toasts for a quick view of tickets, and landscape reports forSuggestions for Improving the Deluge Development Experience
Hello, I would like to share some ideas that could significantly improve the Deluge development experience, especially for partners and developers building larger solutions across the Zoho ecosystem. Some key areas that would add a lot of value: DelugeNext Page