API index guide

API or Application Programming Interface acts as a connection between applications or softwares, by allowing them to adopt specific functionalities (navigation, emails, payment etc.) within their application. One such functionality that application owners can adopt is transactional email-sending and related actions. This page lists all the APIs available in ZeptoMail. 

The total email size which includes your email headers, body content, inline images, and attachments should NOT exceed 15 MB.

Email-sending API

Method name Method typeURL
Send single email POSThttps://api.zeptomail.com/v1.1/email
Send batch emailPOSThttps://api.zeptomail.com/v1.1/email/batch 
Send single email with templatePOSThttps://api.zeptomail.com/v1.1/email/template 
Send batch email with templatePOSThttps://api.zeptomail.com/v1.1/email/template/batch 

File cache API

Method nameMethod typeURL
Upload File cache POSThttps://api.zeptomail.com/v1.1/files?name=logo.jpg 

Suppression list API

Method nameMethod typeURLOAuth scopeOperation
Add a suppression list entryPOSThttps://api.zeptomail.com/v1.1/suppressions/{type} Zeptomail.Suppressions.AllCREATE
Edit a suppression list entryPUThttps://api.zeptomail.com/v1.1/suppressions/{type} UPDATE
Fetch suppression list entriesGEThttps://api.zeptomail.com/v1.1/suppressions/{type} READ
Delete a suppression list entryDELETEhttps://api.zeptomail.com/v1.1/suppressions/{type} DELETE

Templates API

Method nameMethod typeURLOAuth scopeOperation
Add a new templatePOSThttps://api.zeptomail.com/v1.1/mailagents/{mailagent-alias}/templates Zeptomail.MailTemplates.AllCREATE
Edit an existing templatesPUThttps://api.zeptomail.com/v1.1/mailagents/{mailagent-alias}/templates/{template-key} UPDATE
Fetch single templateGEThttps://api.zeptomail.com/v1.1/mailagents/{mailagent-alias}/templates{template-key} READ
Fetch multiple templatesGEThttps://api.zeptomail.com/v1.1/mailagents/{mailagent-alias}/templates?offset=*&limit=* READ
Delete a templateDELETEhttps://api.zeptomail.com/v1.1/mailagents/{mailagent-alias}/templates{template-key} DELETE

API error codes: The commonly intercepted errors while using APIs can be found here. This will help you better handle them.