Get All Email Templates
Retrieve a paginated list of email templates in your CPaaS account.
Endpoint
get /mailagents/{mailagent-alias}/templates
Copy full URL
Request URL
https://cpaas.zoho.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.
Example
your-mailagent-alias
- Query Parameters
offsetintegerOptional
Starting position for pagination. For example, to fetch the 9th template, set offset to 8.
Example
0
limitintegerOptional
Number of templates to return per request.
Example
25
Sample Request
Curl
Java
Python
Deluge
Copied!
curl --request GET \
--url 'https://cpaas.zoho.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
- HTTP code 400
Response Body - application/json
JSON Object
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.