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
Cannot receive emails
Sent one days ago still no feedbacks, cannot call customer services numberRating system button not translated to Spanish + "Done"
I've run into a issue with the new system for rating support interactions when the chat is ended: Missing Spanish translation: The button is still showing in English as "Done," even though the interface language is set to Spanish. It should display somethingDeprecation Notice: OpenAI Assistants API will be shut down on August 26, 2026
I recieved this email from openAI what does it means for us that are using the integration and what should we do? Earlier this year, we shared our plan to deprecate the Assistants API once the Responses API reached feature parity. With the launch of Conversations,Zoho Cliq not working on airplanes
Hi, My team and I have been having this constant issue of cliq not working when connected to an airplane's wifi. Is there a reason for this? We have tried on different Airlines and it doesn't work on any of them. We need assistance here since we are constantlyCompleted Calls don't associate with Scheduled Calls
I schedule calls at specific times so that they are easily viewable on my phone. I open a given call on my phone and use the call icon at the bottom of the screen. I complete the call and select "yes" when asked if I want to log the call. I enter theNeed Parallel Transitions for Zoho Desk Blueprint
Zoho CRM's Blueprint already supports Parallel/Multiple Transitions, letting multiple transitions run simultaneously between two states (refer to https://help.zoho.com/portal/en/kb/crm/process-management/blueprint/articles/parallel-and-multiple-transitions-configuration-and-usage#Using_Parallel_Transitions)Zoho Forms integration Google Sheets
Hi, quick one. I wonder if you can help. I have a Zoho Form integrated to a Google Sheet. The fields are showing across the top, but no records are there. I have checked in Zoho Forms to see if there have been any failed integrations, but there are none.ZoHo Mail & MCP connectors
Is ZoHo working an MCP connector for mail?? I find it very useful in Gmail to have Claude summarize messages for me. Thanks Jim P.S. Sorry if this is the incorrect forum. Mods please adjust as necessary.Introducing the Required Skills field for Job Openings
We're excited to announce a new enhancement to the Job Openings module - the Required Skills field, formerly known as the Skillset field. This enhancement brings improved functionality and a fresh UI to help you define your job requirements effortlessly.ZDialer app sign in replys: Account doesn't exist
I couldn't find Zoho Voice for a category. Problem: I have an active Zoho account with Zoho Voice and Zoho CRM. I can successfully sign into both services from my computer using my email address. However, the ZDialer mobile app redirects to accounts.zoho.comChecking validity of fields when converting Leads
Hello, When converting a lead to a contact (and Company), we want to check beforehand if some fields are filled. Ideally a script or action should be triggered to check the fields and then continue if all is fine, or display a message and stop the process. Reasons: Leads are created with few data at the beginning (often name and email), and with time the profile is augmented. Until it reaches some minimal data, this leads shouldn't be convertable as Contacts. Contacts are people we are making businessIs it possible to have conditional pages?
We have a Document, which consists of multiple different subdocuments. We want to have the subdocuments as pages inside a doc and only show them in specific cases. Is it possible to have conditional pages inside of a mail merge based on CRM data?Reports not adding up
I have a subform that we add lines for costs. These are added up in the aggregate (see image 1). When I pulled these into reports, I link the aggregate subform cost, but it keeps adding each subform line, instead of just the PO Subject and the numbers【西日本初開催】「AI and DX Summit 2026」のご案内
ユーザーの皆さま、こんにちは！ 西日本初開催となるZoho ユーザー / 検討中の方々向けイベントのご紹介です。 AI・DX大型カンファレンス「AI and DX Summit 2026」を、2026年7月16日（木）に開催します。 会場は、ウォルドーフ・アストリア大阪。 グラングリーン大阪直結のラグジュアリーな空間で、AIとDXの最新トレンド、実践事例、 展示、ネットワーキングが集結する、特別な1日をお届けします。 👉イベントページを見る ━━━━━━━━━━━━━━━ AIとDXの“今”を、体感。creating an alias
your instructions for creating an alias are wrong. there is no add alias in my mail account. also i dont have a control panel link just a settings link how do i really make an aliasSet Mandatory Lookup Fields in Ticket Layout
I added a custom module called 'Site' in the desk. I also added a lookup field 'Site' in the ticket layout. Now, I want the 'Site' field to be mandatory in the blueprint transition. How can I do that?viewing deactivated users on a calendar
I was just on help chat Me: Ok, Can i verify that I understand correctly? If i fire someone, I need to deactivate them in zoho asap so they don't have access to company data (like customers). When I do that, there is no way to see them on the CRM calendarNon-depreciating fixed asset
Hi! There are non-depreciable fixed assets (e.g. land). It would be very useful to be able to create a new type of fixed asset (within the fixed assets module) with a ‘No depreciation’ depreciation method. There is always the option of recording landReconciliation: don't auto-select transactions outside the entered Period
When initiating a reconciliation for a defined Period (say April 1 to April 30), Zoho Books auto-checks transactions whose Statement Detail dates fall after the period end date. With "Show based on grouped bank statements" enabled (the default), the screenSettling Credit Card Payments
Hello All, Been using Zoho books recently. The banks have been configured to add credit cards as a liability account in the chart of accounts. we have incurred payments and have recorded these expenses as paid thru credit card However when it comes toIntegrations of freelancing websites
It is a customized effort which we require to be implemented on our Zoho recruit. We want that Upwork and Freelancer and other such freelancing websites get integrated into our Zoho Recruit, so that, any communication which we do with the candidates from those websites gets directly recorded on our Zoho recruit and we don't have to move back and forth by opening any other application other than Zoho. If this can be done, we think of managing the entire communication through Zoho recruit and use itCreate Package From A Picklist
Dear Zoho, Can it be made possible to create a package from a picklist? The reason our company makes a picklist is for that to become a package Our sales orders have 600-1000 items I hope that makes it clear that it's hard to delete 990 items when weAbility to Set Client Name During Portal Invitation
Hi Zoho Team, We would like to suggest an important enhancement to the Zoho Creator Client Portal functionality. Zoho Creator recently introduced the option to set a client’s display name in the Client Portal settings, which is very helpful for creatingOnce the photo is clicked, the image is not making a reliable match against profile image on the organization's Zoho People database.
Please advise how to improve reliability of the kiosk image match for clocking in/out. We are trialing this however not having success after the first image match. I'm guessing these matched because the profile image was taken the same day and the employeeAnnouncing new features in Trident for Mac (1.38.0)
Hello everyone! We’re excited to introduce the latest updates to Trident, which are designed to take workplace communication to the next level. Let’s dive into the details. Access message drafts from anywhere. Have you ever typed out a detailed responseDirect Access and Better Search for Zoho Quartz Recordings
Hi Zoho Team, We would like to request a few enhancements to improve how Zoho Quartz recordings are accessed and managed after being submitted to Zoho Support. Current Limitation: After submitting a Quartz recording, the related Zoho Support ticket displaysCelebrating the businesses behind Bigin: Customer Awards 2026
Hello Biginners, We're excited to announce the very first Bigin Customer Awards! If Bigin has played a role in your organization's journey, we'd love to hear about it. Share your story for a chance to be recognized among the best Bigin users across industries.What's New in Zoho Analytics - June 2026
Hello Users! This month is about meeting your data wherever it lives: reaching it from AI assistants, bringing it in from more sources, and keeping it flowing with less manual effort. Here's what's new across Ask Zia and AI, data import, integrations,Quick response appreciated - Vertical line on line graph
Hi, I need to present a line graph showing historical and future data points. What I'd like to do is add a vertical line to denote the current date - to clearly show what is past and what is future. How can I achieve this please? Thank you MarcZoho forms with iframe and Javascript embedding not working
I have integrated zoho forms with iframe and Javascript embedding in my Ruby on Rails application.There is problem form action are not working on clcik on just Chrome browser mobile view ,it's working on Firefox and others.So, what is the solution ofAgentes Zia en Zoho CRM: ¿Qué son los agentes de IA?
Los agentes de IA son entidades digitales autónomas impulsadas por inteligencia artificial que pueden actuar de forma similar a un empleado humano. Los chatbots convencionales y la IA generativa pueden proporcionar información o redactar contenido, y[Free webinar] Creator Tech Connect - Zoho Creator product updates, July 2026
Hello everyone, We’re excited to invite you to another edition of the Creator Tech Connect webinar. About Creator Tech Connect The Creator Tech Connect series is a free monthly webinar comprised of pure technical sessions, where we dive deep into theWhat's New in Zoho POS - June 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 June went. Zoho POS for macOS We are excited to announce that we extended our front end billing applicationDifferent languages for users
Hello, Do you plan to enable individual users to select their languages for interface? Currently language can be changed for everyone - it looks like a settings for a whole portal, which is not good when you are working internationally. Best regards,People 5.0 widget and API questions
While creating Widget for People 5 I found couple issues that I can’t find answer on my own: 1) How to get leave requests according to this API https://www.zoho.com/people/api/get-records-v2.html. I tried: requestData = { "url": "https://people.zoho.eu/api/v2/leavetracker/leaves/records",How to Fix the Corrupted Outlook 2019 .pst file on Windows safely?
There are multiple reasons to get corrupted PST files (due to a power failure, system crash, or forced shutdown) and several other reasons. If You are using this ScanePST.EXE Microsoft inbuilt recovery tool, it only supports the minor corruption issueWhat's New in the Trips Experience
We've redesigned the Trips module to make trip management simpler and more intuitive. Here's a quick look at what's changed. Simplified Trip Creation and Itinerary Management Flexible Trip Creation: You can now create and save a trip without adding itinerariesMise à 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épondre[Important update] : Shopify migrating from REST API to GraphQL API
Dear Shopify integrated users, As part of enhancements, Shopify has deprecated the REST API access and all the integrated apps must comply with the new GraphQL API. Fore more details, visit : https://shopify.dev/docs/api/admin-rest/latest/resources/order#resource-objectFeature request - export as video
Export presentation as video. I think that it would be super useful for many users. ThanksNext Page