Email management APIs
ZeptoMail's REST APIs allow users to send transactional emails like OTPs, password reset emails, invoices and more from their application. They can either use a preset template or build emails from scratch. There is a separate API that handles email-sending using templates. You can learn everything about building email templates in this guide.
Application developers using APIs should authenticate the API requests to ZeptoMail by adding an authorization parameter. This is the Send Mail Token (a unique token for every Agent) that you can generate in your ZeptoMail account. If API requests are made to ZeptoMail without these headers, you will receive HTTP response "401 Unauthorised" error.
Generate send mail token
Follow the steps to generate the Send Mail Token
- Select the Agent that you want to connect to your application.
- Navigate to the SMTP/API section. This will open the Setup Details page.
- From here you can copy your Agent specific send mail token under the API tab.
- You can either use the default Send Mail Token or generate a new one.
Agents >> SMTP/API >> Send Mail Token >> Click to copy icon.
The following APIs are available in ZeptoMail :
Mail Send API - JSON format
JSON messages are passed in the request body. You can go to API documentation section to view:
- Sample curl and Sample API JSON format
- Request Body Parameters
- Success Response Parameters
- Failure Response Parameters
- Status Codes
- Error Codes
- Download the SDK
Note:
Before you get started it is important to know that ZeptoMail is for sending transactional emails like welcome emailers, password resets emails, OTPs. We do not support sending of bulk emails or promotional emails like newsletters or marketing campaign emails. If you are looking for a bulk email provider, you can visit Zoho Campaigns.