Getting started with TransMail

TransMail is a cloud-based, transactional email sending service that helps you to send Transactional emails to your customers. Transactional emails are automated emails, that are triggered by user action from any application. They are usually emails with receipts or OTPs or confirmations and so on, which are triggered by the customer actions in the associated application/ service. Example: Order confirmation emails, Payment failure notification, Password reset emailers are some of the common transactional emails.

When you send the transactional emails through unauthenticated email servers or random applications, the emails might be considered as spam by recipient servers. It also poses a security threat, where the details in the email can be intercepted and misused by spammers. This would indirectly disappoint the customer and hence affect your business reputation. Hence such emails should be sent with proper authentication from email servers that have a remarkable reputation, in order to reach your customer on time and directly in the Inbox. It is highly recommended to use exclusive services like TransMail to send such critical transactional emails to your customers.

Transactional emails are not Newsletters or Marketing emails sent to your leads/ customers and so on.

This guide will help you set up your TransMail account and use your domain with the application to send emails.

Get early access to TransMail

After you signup, you will be greeted by a welcome screen. Once you read and agree to the Terms and Conditions, click Setup TransMail.

Now you will be requested to complete the Customer Validation Form. We need some details about your business to understand your organization and to analyze the type of emails you send. 

Fill in your details in the Customer Validation form and click Submit.


You can set up your domain and the TransMail account, but you will be able to start sending the transactional emails, only after your details are validated at our end. However, you can complete the setup and send test emails, and by then we will have your account validated.

Create the Mail Agent

To begin using TransMail, the first step is to create your Mail Agent.

Mail Agent is used for grouping your transactional emails at a high level. You can set up multiple domains under the same Mail Agent to group the transactional emails from them under a particular category. This helps you to view all the transactions of the processed emails based on the Mail Agent. You can configure webhooks, enable tracking, and upload files that need to be added as inline images or attachments to your email. 

Steps to create the Mail Agent:

  1. Give a name for the Mail Agent. This is basically to help you identify the purpose/ category of the emails sent using this agent. Example: welcome-mailer, mailer etc.
  2. Provide the domain/ subdomain using which you want to send emails. You can set up a new subdomain in case you do not have one. This ensures that the email delivery of the existing accounts does not get affected due to this new setup.
  3. Provide a Description for the Mail Agent based on the nature of transactions. This will help you identify the Mail Agent at a later point of time when you have set up multiple Mail Agents for different purposes.
  4. Click Next to create your first Mail Agent.

Set up your Domain 

In this step, you will learn about configuring your domain and verifying SPF, DKIM, and CNAME records for your domain.

You have to set up your domain or subdomain using which you want to send transactional emails to your customers. This should be easily identifiable by your customers and should be related to the application or service that your customers use.

You need to verify the domain, to prove that you have the necessary permissions to use the domain with the TransMail applications. SPF and DKIM records are used by recipient servers to verify the authenticity of the domain. Once you set up the recommended SPF and DKIM records, your domain will be validated and can be used for sending emails.

When the transactional emails are sent, there may be some cases where the emails could not be delivered to the recipients. There are many reasons for such delivery failures or bounce backs.

Some of the common reasons are:

  • Recipients mailbox is full
  • Recipient has left the organization and his mailbox is deleted
  • Recipient server did not accept emails
  • You may have typed an incorrect email address

In such cases, the email will be bounced back to the return-path address/ bounce email address configured here. This helps you to understand the delivery issues and sort them out.

To receive the bounce emails, you need to configure the CNAME record that is used with TransMail. You need to update CNAME Record to point to TransMail. Click Verify after publishing the CNAME Record.

Steps to verify your domain:

  1. You can verify the domain by adding the SPF, DKIM, and CNAME records in your Domain's DNS Manager.
  2. In case you have access to the DNS Manager, and can do it on your own, copy the records, one by one, and create TXT records and CNAME record in your DNS Manager.


Refer here for instruction specific to popular DNS providers like GoDaddy.

  1. Before you add the CNAME record, you can also edit it. Click on the edit icon next to the CNAME record host value.

  1. Enter the new sub-domain value that you want to use it with your bounce address. 

  1. Click the green tick icon to confirm your new bounce address domain value.
    • Alternatively, if you do not have access to the DNS Manager, you can get the assistance of someone who has the required access to the DNS.
    • You can get assistance by sending an email to the IT administrator or the agency who is managing your domains.
  2. Click Share Record.

  • This will compose an email pre-filled with the required information.
  • You can add your own custom note and send the email, by providing the email address of the contacts who can assist you in this process.

  • Once you have added these records, click Verify for verification.


Based on the TTL of the domain, sometime it may take 24 hours for the records to get propagated across DNS. Hence the domain verification may be delayed, and you may not be able to send emails until then.

Steps to configure the bounce address:

  1. Provide the Bounce address that you want to use in TransMail to receive the email bounces.


The bounce address can be created using your sub-domain only. 

  1. Click Add to add this and proceed to configure your service with TransMail details.

Connect your service

You need to connect your service/ application with TransMail to start sending emails. You will get the username and the SendMail token, that would be needed to send emails. You can connect to TransMail from your application, directly via SMTP or using APIs to send emails.

  • SMTP Method - To connect to TransMail via SMTP method to send your emails, add the following details -
    • Server name -
    • Port number, Authentication - 465 (SSL), 587 (TLS)
    • Username - default username is "emailapikey"
    • Password - Copy the unique password generated for your account.
  • API Method - To connect to TransMail via API method to send your emails, use the Send Mail token in the authorization header of your API request body.
    • Send Mail token - Copy the unique Send Mail token generated for your account.

You can also Download the SDK in this step.

Click Finish to complete the setup process.

Once you complete the setup, TransMail provides you credits worth 10,000 emails, that can be used for free within a period of 6 months.

Send test email

Sending the test emails using this configuration is the final step in your TransMail setup.

Steps to compose and send a test email:

  1. Click Send Emails to compose your first test email using TransMail.

  1. Add From address, Return path (bounce address), To address, Subject, and test email content.
  2. To add additional information on your email headers section, click Add custom headers.
  3. Click Send.

  1. Check the Inbox to confirm the successful delivery of your first test mail using this Mail Agent.


Before you get started it is important to know that TransMail 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/ marketing email sending service, check out Zoho Campaigns.