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:

1. sending email notifications
2. assigning tasks to users
3. updating fields
4. 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:

1. audit the existing email notifications,
2. create new email notifications,
3. update existing email notifications, and
4. 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 Template

For 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

1. name: A unique identifier for your notification (e.g., "LostDealNotification")
2. feature_type: Set to "workflow" for automation-triggered notifications from workflow. 
3. template: The ID and name of the email template you created earlier
4. module: The ID and API_name of the module this  email notification applies to.
5. 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:

1. 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   } }

1. 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   } }

1. 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": {                             "email": ["mark.stevens@zylker.com"]                         },                         "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. 

Previous Kaizen : Kaizen #213 - Workflow APIs - Part 1, Part 2, Part 3 | Kaizen Directory

• 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 this

• Kaizen #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 how

• Kaizen #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

• Restrict Appointment Booking to Approved Clients

  Dear Zoho Bookings Support Team, We'd like to propose a feature enhancement for managing appointments within Zoho Bookings. This feature would ensure only pre-approved clients can schedule meetings. Desired Functionality: We propose the introduction of

• Automate Credit Card Surcharge

  Is there a way to create an automation that will add a 3.0% credit card surcharge to a subscription whenever a customer pays via credit card?

• I have the item field and Quantity field in the sub form , on the submit of the form if the quantity is grater than inventory means show alert on submit validation only for item type goods ,

  I have the item field and Quantity field in the sub form , on the submit of the form if the quantity is grater than inventory means show alert on submit validation . Stock Check Validation only for item type goods , not for item type service . For the

• Disappearance of all articles in the knowledge base

  Hi there! It seems like all of our articles have disappeared from the knowledge base: However, the names still appear in the "sort articles" section:

• Logic for sending to a non-primary email address

  Hi, I have a scenario where contacts are able to sign up for emails with 2 different email addresses (example: work, personal). I've mapped both to Campaigns from Zoho CRM, but when I go to target an email only the primary email addresses are pulling in. How can I update this to look at both of the email addresses - or specifically the secondary email address in Campaigns? Thanks, Jenny

• Add "Reset MFA" Option for Zoho Creator Client Portal Users

  Hello Zoho Creator Team, We hope you are doing well. We would like to request an important enhancement related to Multi-Factor Authentication (MFA) for client portal users in Zoho Creator. Currently, Creator allows us to enforce MFA for portal users,

• Tables for Europe Datacenter customers?

  It's been over a year now for the launch of Zoho Tables - and still not available für EU DC customers. When will it be available?

• NOTAS INVISIBLES

  Siempre que abro mis notas salen invisibles, muchas no resaltan las *negritas* en la vista previa hasta que te metes en ellas y modificas algo. Pero omg con el equipo de Zoho. Les dije que las usaba mucho precisamente por la VISTA PREVIA y encontrar las

• Does Zoho has chatroom/chatbot url feature?

  Hi Zoho community! I’m looking for a quick "Yes/No" answer for my dev team regarding Zoho’s capabilities. We currently use Zoho Desk for our Service Team and Zoho CRM for our Marketing Team to bring both functions under one platform. Our question: Does

• One Support Email Managed By Multiple Departments

  Hello, We use one support email (support@company.com). Incoming emails come to the "Support Department" and based on what the customer is asking, we route that ticket to different departments (billing, technical support, etc.). When users in these different

• Is it Possible to Modify Standard Report Urls

  Is there a way to permanently modify standard report Urls? Use case: Suppose I have a Products report. Showing list as timeline, calendar, or kanban doesn't make sense. Want to hide that from users by adding #Report:Products?zc_ShowAs=false&zc_Print=false

• Updated font library: New font styles and custom font options in Zoho Sheet

  Zoho Sheet's font library now supports 500+ font styles in 60+ languages! The updated font library is stacked with new font styles, and some of the previously available font styles have been replaced with equivalent options. There are two ways you can

• scope for phonebridge in CRM and phonebridge API documentation

  Hi I cannot find the scope to be used for phonebridge in CRM API V2 calls. I am getting OAUTH_SCOPE_MISMATCH for scope group ZohoCRM.modules.ALL,ZohoCRM.setttings.ALL Also I am not able to locate the documentation for the same, All I have is phonebridge

• Job Alerts for Candidates

  hi All, I have 2 questions relating to sharing job details with candidates. 1. is there a way to notify candidates that meet certain criteria of current jobs available? eg. I run a candidate search, and identify 50 candidates that might be suitable. Can

• Zoho Wiki or new Zoho Learn

  We are currently evaluating if we should move off confluence. At present in Confluence we have multiple levels within our documentation but with learn it looks like you can only have Space       - Manual             - Chapter Is it possible to have levels below Chapter? Also the same question for the existing wiki, can I have more sub-levels?

• Fix image at bottom of a page fot automatic proposal creation

  I'm working on a proposal document to automate our proposal creation process. So far it works fine, but I experience some problems with an image I want to have fixed at the bottom of the page AND above the footer. This section of the document consists

• Can't scroll the page down unless I refresh the page

  Hello, This issue has been going on with me and a lot of other users in my organization, we can't scroll down! the scrolling side bar doesn't appear and scrolling down through mouse or keyboard keys doesn't work, it seems that the page just ends in the

• Price List

  II want to restrict the items to display in sales, quote, etc for which custom rates are added in price list. How I can do the same in Zoho books

• Let’s Talk Recruit: Still switching tabs to source?

  Welcome back to the Let’s Talk Recruit series. Let’s talk about how you actually source talent. Do you open multiple job boards every single time a role opens? Run the same keyword searches you ran yesterday? Download, upload, rename, and then do it again

• Kaizen #231 - Embedding Zoho Desk Tickets in Zoho CRM

  Hello, CRM Wizards! This week, let us enhance cross-team visibility between Zoho CRM and Zoho Desk. We will use the Zoho Request Client inside a Related List widget to display open Zoho Desk tickets directly within the Contact record in Zoho CRM. This

• Introducing Job Alerts

  Keeping candidates engaged beyond their first application is one of the most consistent hiring challenges. Many interested candidates simply do not revisit career sites regularly, which can result in missed opportunities and reduced re-applications. To

• Task status - completed - other options

  I have a dumb question I know i can make custom statuses for the tasks - but is there anyway to make additional "completed" statuses like for instance if i have a task "call back customer" and i leave a vm for them to call back marking it "completed -

• Bank feed integration First Abu Dhabi Bank (FAB) to Zoho? (UAE)

  Hello everyone, Is First Abu Dhabi Bank in the list of banks available for bank feed integration with Zoho Books? Thank you.

• How to Export Filtered List of Contacts?

  This seems like it should be simple, but I'm stymied. I'm trying to export a filtered list of my Contacts for analysis in a spreadsheet. The use case is that I'm an ecom business based in the US. The bulk of our customers are individuals stored as Contacts.

• Quick Create needs Client Script support

  As per the title. We need client scripts to apply at a Quick Create level. We enforce logic on the form to ensure data quality, automate field values, etc. However, all this is lost when a user attempts a "Quick Create". It is disappointing because, from

• can we add product images in Zoho CRM Quote PDF template?

  I want to create a quotation format in Zoho CRM similar to the attached PDF, where each product is displayed in a table with rpoduct image I need the product image to appear inside the line items section of the quote. However, while checking the Quote

• Does Zoho Writer have Dropdowns

  I want to add a drop down field in Zoho writer. Is this possible?

• Users Lookup

  It would be extremely convenient to have a lookup field whose type is Users. There are many instances where we need to relate certain actions to users. Furthermore, in our company the candidate sourcer might not be the one who's creating the profile (done by an admin). Please do consider adding this essential feature in the future. Thank you

• Connecting Multiple WooCommerce Stores to a Single Zoho Marketing Automation Account

  Is it possible to connect multiple WooCommerce stores to a single Zoho Marketing Automation account?

• Service Title in Service Report Template Builder

  I am currently working on the Service Report Template Builder in Zoho FSM. I have created three separate service report templates for different workflows: Preventive Maintenance Report Requested Service Report Installation Report My issue is that I cannot

• Update: New Security Admin Role

  Hello Zoho Directory Admins! This post is to highlight the recent role and permission changes introduced as part of the security enhancements. Previously, Helpdesk Admins had the security permissions and were responsible for managing the security configurations

• Client Script | Update #14 - Client Script Support for Quick Create

  Hello Everyone! We are back with another exciting and highly awaited update in Client Script! Over the past months, many of you shared your insights and requests, asking for the power to extend Client Script functionality to Quick Create forms. This capability

• I'd like to suggest a feature enhancement for SalesIQ that would greatly improve the user experience across different channels.

  Hello Zoho Team, Current Limitation: When I enable the pre-chat form under Brands > Flow Controls to collect the visitor’s name and email, it gets applied globally across all channels, including WhatsApp, Messenger, and Instagram. This doesn't quite align

• The Social Playbook - February edition: Why moment marketing works (and how brands use it)

  Imagine the final season of your favorite series is about to drop. Your entire feed is talking about it. Trailers everywhere. Fan theories. Hype at 100%. Now your go-to burger place launches a limited-edition meal box themed around that series—custom

• PDF Attachment Option for Service Reports

  Hello Team, I would like to check with you all if there is an option to attach PDF documents to the service reports. When I try to attach a file, the system only allows the following formats: JPEG, JPG, and PNG. Could you please confirm whether PDF attachments

• Cliq Bots - Post message to a bot using the command line!

  If you had read our post on how to post a message to a channel in a simple one-line command, then this sure is a piece of cake for you guys! For those of you, who are reading this for the first time, don't worry! Just read on. This post is all about how

• 【Zoho CRM】営業日のロジックに関するアップデート

  ユーザーの皆さま、こんにちは。コミュニティチームの中野です。 今回は「Zoho CRM アップデート情報」の中から、営業日のロジックに関するアップデートをご紹介します。 本アップデートにより、ワークフローにおける営業日の計算方法が改善されました。 週末などの非営業日にワークフローのトリガーが発生した場合でも、 「+0」「+1」「+2 営業日」といった設定が、意図どおりに正確に動作するようになりました。 営業日に基づくワークフローでは、日付項目を基準に「何営業日後に処理を実行するか」を指定します。

• Merged cells are unmerging automatically

  Hello, I have been using Zoho sheets from last 1 year. But from last week facing a issue in merged cells. While editing all merged cells in a sheet became unmerged. I merged it again, but it again unmerged. In my half an hour work I have to do this 3-4

• Just want email and office for personal use

  I am unclear as how to how I would have just a personal email (already do have it and love it) and get to use docs, notebook, workdrive etc. In other words mostly everything I had a google. I find gocs can be free with 5gb and so can mail with 5gb. Are

• Unable to change the "credentials of login user" option when creating a connection

  I want to create a new Desk connection where the parameter to use 'credentials of login user' is set to YES. I'm able to create a new connection but am never given the option to change this parameter. Is this a restriction of my user profile, and if so,

• Next Page