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/v7/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
}
}