Email Templates

Purpose

To fetch the email templates in a module.

Request Details

Request URL

All - {api-domain}/crm/{version}/settings/email_templates
Specific - {api-domain}/crm/{version}/settings/email_templates/{id}

Header

Authorization: Zoho-oauthtoken <access_token>

Scope

scope=ZohoCRM.templates.email.READ

Parameters
  • modulestring

    The API name of the module you want to fetch email template from. Supported modules are:
    Leads, Accounts, Contacts, Deals, Tasks, Events, Calls, Products, Price Books, Quotes, Sales Orders, Purchase Orders, Invoices, Campaigns, Vendors, Cases, Solutions, and Custom.

Note
  • The content key contains the HTML of the email template and is rendered in the response only when you fetch a specific email template.

Sample Request

Copiedcurl "https://www.zohoapis.com/crm/v5/settings/email_templates"
-X GET
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

Response JSON Keys

  • created_timestring

    Represents the date and time at which the email template was created.

  • attachmentsJSON array

    Represents the attachments added in the template.

  • subjectstring

    Represents the subject of the email template.

  • moduleJSON object

    Represents the module with which the template is associated with.

  • created_byJSON object

    Represents the name and ID of the user who created the email template.

  • layoutJSON object

    Represents the layout the template is associated with.

  • modified_timestring

    Represents the date and time at which the email template was last modified.

  • folderJSON object

    Represents the name and unique ID of the template folder.

  • last_usage_timestring

    Represents the date and time at which the email template was last used.

  • associatedboolean

    Represents whether the template is associated or not.

  • namestring

    Represents the name of the email template.

  • consent_linkedboolean

    Represents whether the consent form is linked with the template.

  • modified_byJSON object

    Represents the name and ID of the user who last modified the email template.

  • idstring

    Represents the unique ID of the email template.

  • editor_modestring

    Represents the mode in which the email template is created. The possible values are gallery: the template is chosen from the template gallery and is customized, rich_text: a pre-designed custom template, plain_text: the template is built from scratch.

  • categorystring

    Represents the type of the template. The possible values are normal, draft: the templates that are in draft state, system_templates: the templates present in the system by default, plugin_templates: the templates that are created and installed from the Zoho CRM extension, marketplace_templates: the templates that are created and installed from the published plugins.

  • last_version_statisticsJSON object

    The statistics such as the number of emails that were opened, tracked, delivered, bounced etc., that used this template.

  • favoriteboolean

    Represents if the email template is marked as favorite.

Possible Errors

  • BAD_REQUESTHTTP 400

    The request method specified is invalid.
    Resolution: Specify the request method as GET.

  • OAUTH_SCOPE_MISMATCHHTTP 401

    The token does not have the scope ZohoCRM.templates.email.READ.
    Resolution: Create a token with the scope ZohoCRM.templates.email.READ.

  • NO_PERMISSIONHTTP 403

    You do not have the permission to read the email templates.
    Resolution: Contact your administrator.

  • INVALID_URL_PATTERNHTTP 404

    The request URL has syntactical errors.
    Resolution: Correct the syntactical errors in the request URL.

Sample Response

Copied{
    "email_templates": [
        {
            "created_time": "2020-07-10T16:29:50+05:30",
            "attachments": null,
            "subject": "New contact created",
            "module": {
                "api_name": "Contacts",
                "id": "3652397000000002179"
            },
            "last_version_statistics": {
                "tracked": 1,
                "delivered": 1,
                "opened": 0,
                "bounced": 0,
                "sent": 1,
                "clicked": 0
            },
            "created_by": {
                "name": "Patricia Boyle",
                "id": "3652397000000186017"
            },
            "modified_time": "2020-07-10T16:30:26+05:30",
            "folder": {
                "name": "Public Email Templates",
                "id": "3652397000000000077"
            },
            "last_usage_time": "2021-03-17T18:36:00+05:30",
            "associated": false,
            "name": "Contact created",
            "consent_linked": false,
            "modified_by": {
                "name": "Patricia Boyle",
                "id": "3652397000000186017"
            },
            "id": "3652397000002497001",
            "editor_mode": "gallery",
            "category": "normal",
            "favorite": false
        },
        {
            "created_time": "2019-07-17T10:56:33+05:30",
            "attachments": null,
            "subject": "Record(s) Deleted in CRM",
            "module": {
                "api_name": "Leads",
                "id": "3652397000000002175"
            },
            "last_version_statistics": {
                "tracked": 0,
                "delivered": 0,
                "opened": 0,
                "bounced": 0,
                "sent": 0,
                "clicked": 0
            },
            "created_by": {
                "name": "Patricia Boyle",
                "id": "3652397000000186017"
            },
            "modified_time": "2019-07-17T10:56:33+05:30",
            "folder": {
                "name": "Public Email Templates",
                "id": "3652397000000000077"
            },
            "last_usage_time": "2022-10-26T11:55:45+05:30",
            "associated": true,
            "name": "Delete Records Notification",
            "consent_linked": false,
            "modified_by": {
                "name": "Patricia Boyle",
                "id": "3652397000000186017"
            },
            "id": "3652397000000892003",
            "editor_mode": "gallery",
            "category": "normal",
            "favorite": false
        },
        {
            "created_time": "2018-11-14T15:30:13+05:30",
            "attachments": null,
            "subject": "Big Deal Alert",
            "module": {
                "api_name": "Deals",
                "id": "3652397000000002181"
            },
            "last_version_statistics": {
                "tracked": 1,
                "delivered": 2,
                "opened": 1,
                "bounced": 0,
                "sent": 4,
                "clicked": 1
            },
            "created_by": null,
            "modified_time": "2018-11-14T15:30:13+05:30",
            "folder": {
                "name": "Public Email Templates",
                "id": "3652397000000000077"
            },
            "last_usage_time": "2022-11-21T15:12:14+05:30",
            "associated": true,
            "name": "Big Deal Alert",
            "consent_linked": false,
            "modified_by": null,
            "id": "3652397000000000079",
            "editor_mode": "rich_text",
            "category": "system_templates",
            "favorite": false
        }
    ],
    "info": {
        "per_page": 200,
        "count": 3,
        "page": 1,
        "more_records": false
    }
}