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

• SalesIQ Chat Owner to CRM Lead Owner Mapping

  There is no proper mapping between the SalesIQ chat owner and the CRM lead owner. When a chat is assigned to an agent, the lead created in CRM is often assigned to a different user, forcing admins to manually change ownership every time. This creates

• Automatic Email Alerts for Errors in Zoho Creator Logs

  Hello, We would like to request a feature enhancement in Zoho Creator regarding error notifications. Currently, Zoho Creator allows users to view logs and errors for each application by navigating to Zoho Creator > Operations > Logs. However, there is

• [Webinar] Agentic AI and its influence on analytics and autonomous decision-making

  Analytics is evolving from passive reporting to proactive, intelligent systems. Agentic AI is at the center of this shift, bringing context-aware reasoning, continuous learning, and the ability to act on data in real time. Join this webinar with Michael

• Zoho One: books and inventory working together

  Hi, I was very pleased when I saw that in Zoho Inventory can now pull the orders from Woocommerce. They are now fed in Inventory as Sales order and with choosing convert invoice as Instant Invoice I am getting the exact data as they appear in Woocommerce.

• Zoho Forms - Form Availability Redirect Option

  Hi Forms Team, It would be great if there was a redirect URL option on the Form Availability settings. For example, I would like to create a support form which is only available outside business hours and if the current data and time is not Mon-Fri 9-5

• VAT and Taxes option not available

  Dear ZOHO Team , The VAT and Taxes options in my ZOHO books account not available,I tried to find how to enable or check the way to use this option but unfortunately couldn't find it anywhere ,I'm in UAE ,kindly let me know what to do to solve this issue

• Syncing zoho books into zoho crm

  I was wondering how I can use zoho books in crm as I have been using them separately and would like to sync the two. Is this possible and if so, how? Thanks

• Client requests I submit invoices using bill.com

  The title states it all. I have a reoccurring invoice setup for this client who has been manually paying by credit card. We are both experiencing merchant costs/fees. The use of bill.com's direct deposit is not far removed from Zoho's, only the client

• Zoho Inventory Feature Roadmap Visible To All

  Hello, please consider making your feature roadmap visible to us users so that we know what to expect in future. This may appease current users who are seeking clarification on feature implementation dates, so that they can make an informed decision whether

• Can't Remove Payment Gateway

  I am getting the error "Settings cannot be cleared as some of the transactions are still in progress." when trying to remove the PayGate payment gateway which I was unable to get working. I am now using paystack and I want to remove Paygate.

• Improve Zoho Vault search

  Hello, we started using Zoho Vault and we really appreciate the app. At the moment, when searching passwords, the search query only targets the password name. I think having the query search among Name, User name, URL, Notes and Tag would be a better

• New in WorkDrive: Personalize your file system with Labels

  Data is the driving force behind every decision made by businesses today. We at WorkDrive know every employee needs reliable access to their information and be able to locate the data they need at the right time.  Introducing Labels: organize your files in a way that's personal to you.  While WorkDrive's Data Templates feature focuses on adding structure to your organization's data, Labels help your team members classify files based on their preference. The Labels created will appear only to the

• Custom Buttons & Links Now Supported in Portals

  We’ve just made portals in Zoho Recruit more powerful and customizable than ever! You can now bring the power of Custom Buttons and Links to your Candidate, Client, Vendor, and Custom Portals, enabling portal users to take direct action without recruiter

• Work Type Section in Field Service Settings

  Hello Team, We are trying to understand how skills are managed in the system. During our review, we found an article mentioning a section called Work Type, which is used to manage skill assignment. According to the documentation, this section should be

• Mirror Component in Zoho CRM: Access real-time related data without leaving your record

  Hi everyone, This feature is now available for the JP, CA, SA, UAE, and AU DCs. We're excited to bring to you Zoho CRM's mirror component, which presents relevant data on a record's details page and keeps everything users need in one place without having

• Clone a Module??

  I am giong to repurpose the Vendors module but would like to have a separate but very similar module for another group of contacts called Buyers. I have already repurposed Contacts to Sellers. Is it possible to clone (make a duplicate) module of Vendors

• Is there lead tracking in Bigin? There should be.

  Is there a way to track leads before they are ready to be added to Pipelines? I'm afraid we're going to lose opportunities. Example: We're sending out small batches of 25 emails to those we collected at tradeshows. They are all qualified leads. Out of

• How to get static reports via Desk API

  Hello, we are hoping to use the Desk API to automatically export the default static reports in Zoho Desk, or reconstruct them via other API calls. What's the best way to do this? For example, if I want to recreate the Response Time static report via the

• Product updates in Zoho Workplace applications | April 2026

  Hello Workplace Community, Let’s take a look at the new features and enhancements that went live across all Workplace applications for the month of April. Zoho Mail Enhance group member exports with additional data fields Customize your group member exports

• Billing Status Update

  Hello Latha, I’m working on a new automation (deluge) to fulfill one of our requirements. In this automation, there is a step to update the Work Order billing status from “Not Yet Invoiced” to “Non-Billable.” I tried to find the API information relevant

• Zoho Projects Coming to CRM Teamspaces

  Availability: The US DC Standard Edition is now available. It will be rolled out to customer accounts in all DCs in phased manner. Hello all, You are probably already familiar with Teamspaces, the dedicated workspaces where teams organize the CRM modules

• Customise Lead Source and Sub Lead Source per webinar

  We have an integration between Zoho Meeting and Zoho CRM. New leads are imported into CRM but now they all have the source "Zoho Webinar". Can I change this source? Can I add a sub source? And can I customize these fields per webinar? (So different webinars

• Zoho Projects Roadshows 2026 - APAC

  Dear Users, Building on the amazing response to our roadshows in 2025, we are excited to announce our next set of roadshows in the APAC region. To start with, our team of experts will conduct these events in Singapore and Manila. They will walk you through

• how do i add more than one google my business location?

  they are connected to one account, but while connecting social channels it makes me pick one location. I have 3 and growing.

• Notes - Reaction Buttons

  Using the native notes option within CRM is fine, it works and the RTF features are great, however, would it be possible - if there isnt already something in place, where we can add a reactions button, similar to teams/whatsapp to show that its been read

• Zoho Analytics: Clarification on Email Schedule Limits in Basic Plan

  Hi Team, I have a question regarding the email scheduling limits in the Zoho Analytics Basic Plan. The plan shows that I can create 4 email schedules. However, I understand that schedule consumption is calculated based on recipients (i.e., 1 schedule

• Zoho → ShipStation Integration – Sales Order–Driven Fulfilment Workflow

  Hello All, I’m reaching out to explore the best way to integrate a shipping tool into our inventory which will speed our process up. We are looking to integrate ShipStation into our existing order-to-fulfilment workflow, as we’re keen to standardise on

• Updating Sales orders on hold

  Surely updating irrelevant fields such as shipping date should be allowed when sales orders are awaiting back orders? Maybe the PO is going to be late arriving so we have to change the shipment date of the Sales order ! Not even allowed through the api - {"code":36014,"message":"Sales orders that have been shipped or on hold cannot be updated."}

• Custom button for list page

  Why is my 'List Page - Bulk Action Menu' button in the Packages module not autopopulating the List argument with selected record IDs?

• Exclude Email or Domain From New Ticket Notification

  Hi, we utilize the new ticket notification feature in Zoho Desk. However, it would be great if there was a way to exclude certain email addresses or domains from receiving the automatic notification. This would be particularly helpful for automated alerts

• Anyone have a working connection with CRM and shipstation via Flow

  Just wondering if anyone has successfully integrated shipstation and Zoho CRM.  I know there’s code to do it but am hoping to find out all the pitfalls before I jump on!! Scenario: SalesOrder gets created in CRM with multiple line items. I want this pushed to shipstation. On shipping via shipstation I want to push the tracking # back to CRM.  Many thanks in advance

• ShipStation and Zoho Inventory

  Hello, I am looking to sync zoho inventory with shipstation ZOHO INVENTORY           SHIP STATION Sales Order  ==>  create ORDERS INVOICE  <==    Shipments What exactly does BETA mean on the Shipstation connector?  This is required for me to sign-on in the next month. Thanks in advance for your efforts

• Connect to Shipstation's API

  Shipstation is a very big service, with lots of users, tons of order data.....and poor un-customizable reporting. This is perfect for Zoho analytics.  The Shipstation API is modern and efficient.  Today I think many people pay Zapier to get Shipstation data into Reports/CRM/Books - why not have  a direct connection?  -can pull in shipments via webhook or polling.  -also nice to pull in order data along with shipment data

• What’s the Correct Integration Flow Between Zoho Inventory, ShipStation, and Multi-Channel Sales Platforms?

  Hi Zoho Community, I’m currently implementing Zoho One to manage all of my business processes, and I’d appreciate some guidance on the correct integration flow for the tools I’m using. Here’s my current setup: Zoho Inventory is my central system for managing

• Remove Zoho Header from Portals

  I have a portal page with custom domain. But when I print directly from a webpage, the Zoho CRM header shows. It kind of kills the branding aspect. Is there a way to get rid of this?

• Setting defaults for "Find and Merge Duplicate for..."

  To remove some of the extreme tedium from Zoho's poorly implemented merge function, I would like to set defaults.  Currently I am defaulted to match "ANY" when I would never do that, so I always have to click "ALL". Then it makes me click on several totally irrelevant drop boxes to turn off phone, mobile and other useless match criteria. Is there a way I can set: Match to default as "ALL" Firstname to default to "IS" Lastname to default to "IS" every other match field default to "-NONE-" This will

• Let's bring Manufacturing Resource Planning (MRP), Material Requirement Planning (MRP), and Production Planning/Management module / feature in Zohobooks

  Let's bring Manufacturing Resource Planning (MRP), Material Requirement Planning (MRP), and Production Planning/Management module / feature in Zohobooks

• CLIENT PORTAL (If clients can place orders directly on the portal)

  Zoho client portal is excellent. Everything is there except one thing. Client should be able to place orders directly on the portal. This would enhance the portal and end users will be extremely happy. This suggestion infact came from one of our client.

• アナリティクスで商談中のパイプライン(ステージ）の件数比較

  アナリティクスで商談中のパイプライン(ステージ）の件数を前週と前々週で比較したい。前々週の件数が更新することで変動してしまう。対象方法をご教授ください。

• How do I remove a data source from Zoho Analytics?

  I am unable to find a delte option on a datasource that i put in the system as an error. On teh web it refers to a setup icon but I do not see that on my interface?

• Next Page