Mail Agents

A Mail Agent in ZeptoMail is used to segment the outgoing transactional emails based on their purpose, application, type and more. This ensures separate channels for each type, ensuring better management and organization. You can associate one or more domains to each Mail Agent for sending out emails.

Create a Mail Agent

By default a Mail Agent will be created during the account creation process. To create additional Mail Agents, follow the instructions below:

1. Log in to your ZeptoMail account.
2. Click the Add Mail Agent icon near Mail Agents in the left panel. 
   
   
    
3. The Add Mail Agent pop-up appears.
4. Provide the Mail Agent Name, Domain, and Description for the new Mail Agent. You can associate multiple domains to a Mail Agent.
   
   
    
5. Click Add to create the new Mail Agent.

Sections of a Mail Agent

Each Mail Agent has multiple sections to help you manage sending, domains and tracking. 

Mail Agent setting

The Mail Agent setting section allows you to do the following :

• IP restriction
• Suppression list
• Sending limits
• Shutdown a Mail Agent

IP restriction list

The IP restriction option allows you to restrict IPs that will be sending emails from your ZeptoMail account. This provides an additional security layer in case your send mail token is inadvertently compromised and prevents unauthorized parties from sending email through your account. To add to the list :

1. Click Add IPs.
   
2. You can either add individual IP addresses or a range.
   
3. Click Add.
4. You will be required to validate your identity, post which the IP will be added to the list. 

Suppression list

The suppression list contains those addresses for which you no longer wish to send any emails and those that you do not wish to track anymore. Apart from email addresses, you can also suppress email-sending to whole domain. You can add the email addresses or domains specific to Mail Agents to this list. To do so:

1. Go to the Suppression list section in the Mail Agent settings section.
2. Choose whether you wish to add the email address or domain from the tab at the top.
   
3. Enter the email address or domain you wish to suppress. Enter the reason for the suppression.
4. Confirm the selection by clicking Add.
5. The suppressed email address or domain will be added to the list.

Sending limits

You can set limits on the number of emails sent from your Mail Agents, based on your usage. This helps you monitor and control your outgoing emails according to your business needs. You can configure individual sending limits for each Mail Agent based on your requirements. The limit you set will automatically reset at 12am server time each day. To set an email limit:

1. Go to the Mail Agent settings section. 
   
2. Select Sending limit.
3. Enter the desired limit for that Mail Agent. Save the limit.

If the number of outgoing email exceeds the set limit:

• For API users, the email will not be processed and you will receive a SM_151 error in your console.
• For SMTP users, your email will be accepted by ZeptoMail servers, but will not be sent out to your recipients. The email will have a Process failed status.

The Settings section lists all the limits set for a ZeptoMail account. You can add, edit or delete the limits from there too. This help page gives you more information on email limit actions in the Settings section. 

Shutdown and Delete a Mail Agent

You can delete the Mail Agents that you no longer use. Only Postmaster has permission to perform the deletion operation. Before deleting the Mail Agent, you have to initiate the Mail Agent shut down process. The shutdown period is for 45 days and your Mail Agent data will not be deleted during this period. After 45 days, ZeptoMail will automatically delete the Mail Agent and its information.

Here are a list of things to keep in mind before initiating the Mail Agent shutdown process:

• Once the shutdown of a Mail Agent is initiated, the process and the associated actions cannot be reverted.
• After the initiation of the shutdown, emails cannot be sent using HTTP or SMTP from the Mail Agent.
• All actions performed by the Mail Agent such as scheduled emails, tracking, webhooks, triggering, etc., will be blocked immediately after the shutdown is initiated.
• After Shutdown, information such as processed email logs, and reports will remain till the deletion of the Mail Agent.
• After the deletion of the Mail Agent, all information corresponding to the Mail Agent except the associated domains will be deleted irreversibly.

Steps to initiate the shutdown process:

1. Log in to ZeptoMail application.
2. Launch Mail Agents section from the left panel.
3. Select the Mail Agent you want to delete.
4. On top right corner click on Mail Agent setting.
5. Click on Shutdown Mail Agent
   
   
    
6. In the Shutdown Initiation popup, agree to proceed and click on Shutdown.
7. You will be required to validate your identity in order to shutdown your Mail Agent. Once validated, it will be deleted.

The Mail Agent will be permanently deleted after the completion of 45 days from the shutdown initiation period. 

Points to remember

• All the domains you add can be associated to a single Mail Agent or multiple Mail Agents.
• The domain should be verified, to use it in the Mail Agent for sending Transactional emails.
• You need to configure a bounce email address with the verified domain in the Mail Agent.
• You can use different domains, for sending different types of Transactional emails from the same MailAgent. This is purely based on your sending requirements.
  • Example: The company Zylker sends two types of transactional emails - Daily reports and account alerts from the same Mail Agent. It uses the sub-domain reports.zylker.com for daily reports and alerts.zylker.com for account alerts. Both these verified sub-domains are part of the same Mail Agent.
• However, you can also send different emails using different Mail Agents. For instance, Zylker can use Mail Agent 1 to send welcome emails and Mail Agent 2 to send daily reports. Mail Agent 1 will have the sub-domain info.zylker.com added to it. Mail Agent 2 will have alerts.zylker.com sub-domain added to it.
• ZeptoMail does not support certain formats of in-line images and attachments. Click here to view the list of unsupported formats.