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

• Desk Contact Name > split to First and Last name

  I am new to Zoho and while setting up the Desk and Help Center, I saw that new tickets created or submitted from the Help Center used the Contact Name field. This would create a new Contact but put the person's name in the Last Name field only. The First

• SalesIQ operators will not receive any messages if customers do not answer the Pre-Chat questions in Flow Controls.

  Hi Zoho SalesIQ Team, I am reaching out to report a issue regarding the Brands > Flow Controls SalesIQ operators will not receive any messages if customers do not answer the Pre-Chat questions in Flow Controls and continue sending messages without completing

• Add Comprehensive Accessibility Features to Zoho Writer

  Hello Zoho Writer Team, We hope you are doing well. We would like to submit a feature request to enhance Zoho Writer with a full set of accessibility tools, similar to the accessibility options already available in the Zoho Desk agent interface. 🚧 Current

• Copying a Document with its Citations

  When I copy a document that contains citations using File>Make a Copy from the document's menu the text copies but the citations do not (according to Google they should). Is this the correct way to make a complete copy of a document with its citations

• Bing ads integration and tracking

  Hi, Is there any way to track Bing ads in the same way that we are able to track google adwords?  It is important for us to be able to determine the conversion rate of our Bing ads.  If this is not possible now, will this feature be added in the future?

• #20 Your Business Shouldn't Stop Just Because You Do

  Imagine you are on a well-deserved vacation. Your clients are expecting invoices at the beginning of the month, recurring customers are due for billing, and payments are still coming in. Do you carry your laptop everywhere, hoping you don't miss a billing

• Marketing Tip #26: Optimize product images for SEO

  Product images can do more than make your store look good. They can also help customers discover your products through search. Since search engines can’t "see" images, they rely on text signals to understand what an image is about. Two small actions make

• Automation Series: Mandatory Time Logging Before Task Closure

  In a project, when users work on multiple tasks simultaneously, they track time in different ways, either by starting a timer or by adding a time log. Sometimes users may forget to add time, which can lead to discrepancies in the timesheet. When timesheets

• Is there a way to show contact emails in the Account?

  I know I can see the emails I have sent and received on a Contact detail view, but I want to be able to see all the emails that have been sent and received between all an Accounts Contacts on the Account Detail view. That way when I see the Account detail

• Introducing document visibility in Zoho Sign

  Hello! Complex document workflows often involve multiple stakeholders with different roles. Sending a separate envelope to every person is time consuming and can lead to administrative bottlenecks. With Zoho Sign's document visibility feature, you can

• Sent email stuck on processing

  My sent emails are stuck on processing, whats going on?

• [Webinar] What's new in Zoho Analytics: Q2 2026

  Hey data lovers! Our What's New webinar series is bringing you another lineup of exciting features and product enhancements from the past quarter, all designed to help you get more out of your analytics. Get an inside look at new data connectors, Zoho

• Alterar número de telefone para receber o código OTP

  Boa tarde! Como posso alterar o número de telefone da minha conta para aceder ao meu email corporativo? Estou tentando logar, mas não consigo, pois está sendo enviado o código OTP para o número antigo, preciso aceder urgente meu email, porque e de trabalho.

• Request to Increase URL Field Character Limit

  Hi Arthi, Hope you are doing well. I'm trying to save a URL in the Work Order (WO) module using the URL field, but I receive the following error message: "Please enter a valid Repair File. Maximum 450 characters are allowed." The issue is that the URL

• How to change column headings in pivot table?

  Hi, Is there a way to rename the column headers of a pivot table? Now some the columns are named with value labels: 'SUM of .....'. We would like to rename those headers. As of now we couldn't find any direct solution to adjust the headers, besides copying and reformat. We want to avoid these extra steps. Best, Tiemen

• Undelivered Mail

  I suspect that there are recipient's servers that blocks my emails. I receive the following email from mailer-daemon@mail.zoho.eu : A message that you sent could not be delivered to one or more of its recipients. This is a permanent error. pantelis.sarantos@unipakhellas.gr,

• Email not loading on PC

  Hello, my email opens on but it doesn’t load on PC. I don’t have other issues with the email, all the configurations are ok and I face with following issue in the photo. It says “ mail.zoho.com refused to connect” I will be very thankful if anyone can

• Why are bounce/error emails being sent to info@ instead of contact@?

  I have my Zoho Mail and WordPress site configured so that normal website emails should go to contact@hybridbatteryservice.com. However, I keep receiving technical bounce/error emails and delivery failure notifications at info@hybridbatteryservice.com

• Do Not Disturb status not respected when Cliq bar is enabled across Zoho apps

  Hi Zoho Cliq team, I want to report what appears to be a bug with how the Do Not Disturb status interacts with the embedded Cliq bar in other Zoho apps. **Issue:** When my Cliq status is set to Do Not Disturb, I continue to receive notification tones

• Zoho Webinar Summer Broadcast 2026

  What if your webinar platform could connect directly with your business tools, automate routine tasks, trigger actions across your workflows, and support every stage of your webinar lifecycle? That’s the question we’ve been answering so far this year.

• Invalid request when trying to access Mail

  When I click on the red button to access Zoho Mail at https://mail.zoho.com/zm/, I get a big yellow warning triangle with "invlid request, The input passed is invalid or the URL is invoked without valid parameters. Please check your input and try ag

• Whats the average response time for ticket submitted?

  I submitted a request to unblock my mail accounts. They seem to be blocked for outgoing mail, and I have been waiting for days to have this fixed with no reply. I have submitted 2 tickets and an email. My work has to completely stop. I pay for the service

• All new Address Field in Zoho CRM: maintain structured and accurate address inputs

  Availability Update: 29 September 2025: It's currently available for all new sign-ups and for existing Zoho CRM orgs which are in the Professional edition exclusively for IN DC users. 2 March 2026: Available to users in all DCs except US and EU DC. 24

• Is there any way to have Dataprep ingest RSS?

  As stated by the title. Does the Zoho environment offer tools that I can use to, directly or using workarounds, have Dataprep ingest an RSS feed? Thanks

• Introducing Color Coding of Picklist Values

  Dear Everyone, Greetings!! Zoho CRM is uplifting the user experience. Recently, we had some notable aesthetic improvements in CRM like Kanban View UI enhancement, New List view UI enhancement, color coding of tags, and color coding of picklists in meetings.

• Important updates to your Widget JS APIs

  Hello everyone, Greetings from Zoho Creator! This is an urgent notice for developers and Partners who use widgets in their Zoho Creator applications. We previously announced an update to the CDN URLs used for loading the Widget JS API, with a deadline

• Deluge sendmail in Zoho Desk schedule can't send email from a verified email address

  I am trying to add a scheduled action with ZDesk using a Deluge function that sends a weekly email to specific ticket client contacts I've already verified the email address for use in ZDesk, but sendmail won't allow it in its "from:" clause. I've attached

• Mailbox delegation “Send As” error

  I believe there may be an issue with mailbox delegation. When I create a delegation from the Admin Console, it works correctly if I select Read permissions. However, if I select Send As permission for the delegated user, I immediately receive the following

• Restrict Zoho Cliq Webinars and Announcements to Admins Only

  Hi Zoho Team, We hope you're doing well. We would like to raise a feature request regarding in-app announcements in Zoho Cliq, such as the recent webinar popup about the Cliq Developer Platform: While these announcements are useful, they are not always

• how do i get mail.mydomain.com to point to zoho mail web-mail?

  I have started using zohomail, and am loving it. With my previous provider, I used to go to mail.mydomain.com, and it would take me to my webmail. I am not able to find the mapping for zoho's webmail to map to it. It is difficult to go to webmail with

• Number of decimal places

  Hi Latha, I have added the following three fields to the Company module. Currently, these fields only allow a maximum of 2 decimal places. However, for some of our requirements, we need to enter values with up to 10 decimal places. Could you please help

• zoho imap connection stopped working 05/28 12pm EST

  Hi, beginning Thursday, 5/28, ~12 pm est imap to siteground stopped working. When I tried to reconnect the account, connection was failing with the following message: Unable to connect SMTP server:gvam1107.siteground.biz, Port: 587. I did notice that

• User Name in Zoho Cliq Not Updating Across Apps?

  We updated the name of a user in Zoho. (From Sue to Taylor) Her name has not been updated in Cliq on all apps. When in Zoho One, if I go to Cliq directly, it is correct, but if I am in another app, and the Cliq bar pops up on the bottom, it will be the

• Service currently unavailable

  The Zoho Mail Webmail is working, the Mail Admin Console is not: "Our service is temporarily unavailable, please try after sometime." How long must I wait to retry? edit: To add to this, the Webmail is not working 100% - I can open mail in the inbox,

• Service currently unavailable

  Service currently unavailable It is not possible to access email; the entire Zohoworkplace platform is down

• User Permission Log

  Our external auditors are asking for a way to view changes made to user permissions (basically, a user permission change log). Is this feature built into Creator? 

• E-mail down

  We cannot get into our email inboxes, are you affected by a Microsoft update issue? How long do you think as to restoration?

• ZOHO MAIL SERVICE NOT WORKING

  Hello i've a problem my zoho mail account says a display with this text "our service is temporally unavaible"

• ايميل مجانى

  Can I create a free email account on Zahoo?

• Sign up for email for a domain

  Hi - I thought I had signed up for a domain of <domain>.com, but only see the email of @zohomail.com . How do I get the <domain.com> domain linked to my email?

• Next Page