Delete Email Notifications

Purpose

To delete email notifications configured in your Zoho CRM account.

Endpoints

  • DELETE /settings/automation/email_notifications/{email_notification_ID}
  • DELETE /settings/automation/email_notifications?ids={email_notification_ID1},{email_notification_ID2},..

Request Details

Request URL

To delete a specific email notification:
{api-domain}/crm/{version}/settings/automation/email_notifications/{email_notification_ID}

To delete multiple email notifications:
{api-domain}/crm/{version}/settings/automation/email_notifications?ids={email_notification_ID1},{email_notification_ID2},..

Supported modules

Leads, Accounts, Contacts, Deals, Tasks, Meetings, Calls, Products, Quotes, Sales Orders, Purchase Orders, Invoices, Campaigns, Vendors, Price Books, Cases, Solutions, and Custom

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Scope

ZohoCRM.settings.automation_actions.{operation_type}

Possible operation types

ALL - Full access to email notifications
DELETE - Delete email notifications

Parameters

  • idsstring, optional

    It represents the unique ID of the email notification that you want to delete. Skip this parameter if you have specified the ID in the request URL. You can pass upto 10 ids in this parameter in comma separated format.

Sample Request

Copiedcurl "https://www.zohoapis.com/crm/v8/settings/automation/email_notifications?ids=6660682000001430003,6660682000001445001,6660682000001430012"
-X DELETE
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

Possible Errors

  • INVALID_REQUEST_METHODHTTP 400

    Invalid HTTP method to access the API URL.
    Resolution: Check the HTTP Method of the request.

  • NOT_ALLOWEDHTTP 400
    • This email notification is associated with at least one of Approval Process/Workflow Rules/Blueprint.
    • Alert is associated with commandcenter

    Resolution: You can delete the email notification after disassociating it from the corresponding automation.

  • OAUTH_SCOPE_MISMATCHHTTP 401

    You do not have the scope required to use this API.
    Resolution: Use the correct scope and generate the grant and access tokens.

  • NO_PERMISSIONHTTP 403

    Permission denied.
    Resolution: This error occurs when the user doesn't have permission. Contact administrator to obtain manage workflow permission.

  • INVALID_URL_PATTERNHTTP 404

    The request URL is incorrect.
    Resolution: Specify a valid request URL. Refer to the request URL section at the beginning of this page for more details.

  • INTERNAL_ERRORHTTP 500

    Unexpected and unhandled exception in Server.
    Resolution: Contact support team at support@zohocrm.com.

Sample Response

Copied{
    "email_notifications": [
        {
            "code": "SUCCESS",
            "details": {
                "id": "6660682000001430003"
            },
            "message": "email notification deleted successfully",
            "status": "success"
        },
        {
            "code": "SUCCESS",
            "details": {
                "id": "6660682000001445001"
            },
            "message": "email notification deleted successfully",
            "status": "success"
        },
        {
            "code": "SUCCESS",
            "details": {
                "id": "6660682000001430012"
            },
            "message": "email notification deleted successfully",
            "status": "success"
        }
    ]
}