Get All Email Templates
Retrieve a paginated list of email templates in your ZeptoMail account.
Endpoint
get /mailagents/{mailagent-alias}/templates
Copy full URL
Request URL
https://api.zeptomail.com/v1.1/mailagents/{mailagent-alias}/templates Copied!
Scope
Zeptomail.MailTemplates.READCopied!
(or)
Zeptomail.MailTemplates.ALLCopied!
Request Parameters
- Path Parameters
mailagent-aliasstringMandatory
Unique alias of the Mail Agent.
- Query Parameters
offsetintegerOptional
Starting position for pagination. For example, to fetch the 9th template, set offset to 8.
limitintegerOptional
Number of templates to return per request.
Sample Request
Curl
Java
Python
Deluge
Copied!
curl --request GET \
--url 'https://api.zeptomail.com/v1.1/mailagents/{mailagent-alias}/templates?offset=0&limit=25' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Response Parameters
- HTTP code 200
Response Body - application/json
JSON Object
Show Sub-Attributes
dataJSON Array
Show Sub-Attributes
created_timestring
template_keystring
template_namestring
subjectstring
template_aliasstring
statusstring
- HTTP code 400
Response Body - application/json
JSON Object
Possible Response Codes
200HTTP code
List of email templates.
400HTTP code
Bad Request
Sample Response: HTTP 200
Copied!
{
"data": [
{
"created_time": "2025-06-04T08:19:00Z",
"template_key": "1234567890",
"template_name": "E-invite",
"subject": "Invitation to the event",
"template_alias": "invitemail"
}
],
"status": "success"
}
▼ Show full
Sample Response: HTTP 400
Copied!
{
"error": {
"code": "TM_404",
"message": "Template not found"
},
"status": "failure"
}
▼ Show full
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.