Get All Email Templates

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

Retrieve a paginated list of email templates in your ZeptoMail account.

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
Show Sub-Attributes
errorJSON Object
Show Sub-Attributes
codestring
messagestring
statusstring

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