Bounce Address Setup

Bounced emails are emails that failed to deliver. The email delivery failure might be due to permanent reasons (hard bounces) or temporary ones (soft bounces). Some of the common reasons for email bounces:

  • Recipients mailbox being full.
  • Recipient has left the organization and their mailbox is deleted.
  • Recipient server did not accept emails.
  • An incorrect recipient address.

Such bounced emails are returned to a specified address called bounce address. This helps you to understand the delivery issues and sort them out. Bounce address is also called as mail-from address or return-path address. It is mandatory to specify a bounce address before you can send an email. You will be prompted to add the bounce address as a part of your account creation process. Refer the guide here to view the steps in creating your account in ZeptoMail.

Add a relevant prefix and sub-domain name to create a bounce address. This bounce address will now be of the format : prefix@subdomain.domain.com. For example, for the prefix - bounce, subdomain name - invoice and domain name - zylkerstore, the bounce address would be : bounce@invoice.zylkerstore.com.

The bounce address will be sent as a hidden parameter in the email header along with your emails. When your emails bounce, we will fetch the email address causing the bounce and display the data within the processed emails section of your ZeptoMail account. Having a separate sub-domain to receive your bounced emails will help categorising them better.

Note:

  • Bounce Address can be created only for verified domains (SPF, DKIM, and CNAME).
  • Information about bounced emails can be viewed in the Processed Email tab within your Mail Agent.

Create your Bounce Address

You can go to a specific Mail Agent and add the bounce address under the domains section or directly go to the Domains tab on the left panel and create it under a domain.

Create Bounce Address within a Mail Agent 

  1. From the left panel, click on Mail Agents and select a Mail Agent where you want to create the bounce address.
  2. Navigate to Domains tab. If you have already verified your domain (SPF, DKIM, & CNAME) then proceed to the next step. If your Domain is not verified, go to the Domain Verification section to learn how to complete the domain verification process. 
  3. Click on the Add button under the Bounce Address section to create a new bounce address. 
  4. Enter the bounce address name and click on Save.

Create Bounce Address within the Domains tab

  1. From the left panel, click on Domains and select a Domain for which the bounce address has to be created.
  2. Choose the verified domain for which you want to add the bounce address. If your Domain is not verified, go to the Domain Verification section to learn how to complete the domain verification process. 
  3. Click on the ​Add button under the Bounce Address section to create a new bounce address. 
  4. Enter the bounce address name and click on Save.

Add multiple Bounce Addresses to your domain

If you want to send different types of transactional emails like welcome emailers and notifications from the same domain but want to receive the bounces for welcome mailers and bounces for notifications in separate mailboxes, then you need to create more than one bounce address for this domain. A maximum of two bounce address can be added for a particular domain.

Hover over the domain section in the Mail Agent or the Domains menu on the left pane to add the bounce address using the steps given above.

Set a default Bounce Address

If you add multiple bounce addresses to your domain, then you can set one of the bounce addresses as your default bounce address. That means, if you fail to mention the bounce address in your SMTP/ API, the default bounce address will be used as the bounce address. You can set a bounce address as default by click on the Set as default button.

The default bounce address will be indicated in the list. If there is only one bounce address added for a domain, then it becomes your default bounce address. 

 

Delete your Bounce Address

  1. Go to the Domains section within your Mail Agent or click on the Domains tab on the left panel.
  2. Identify the domain whose bounce address has to be deleted.
  3. Navigate to the Bounce address section and click on delete icon for the bounce address you want to delete.
  4. Click ok to confirm the deletion.

If a deleted bounce address is used in your API, you will receive SM_113 error. Refer API error codes here.

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.