Domain Verification for Mail Agents

In TransMail, a Mail Agent groups your transactional emails at a high-level. Domains are added and verified within a Mail Agent. For example, OTP emails can be send using one Mail Agent and Account confirmation emails using another Mail Agent. So the first step is to create a Mail Agent. After you create your Mail Agent, the next step is to add your domains. The added domains must be verified. Emails sent using trusted and verified sender domains reach the recipient's inbox. Other's are either placed in the spam folder or rejected by the Email Service Provider.

Note:

It is mandatory to verify your added domains before you can send your transactional emails. Verifications to be done:

  •  SPF and DKIM validation are configured for domain verification.
  • CNAME record is configured for bounce address setup. Once the bounce address is created, use this bounce address in your SMTP/ API. 

Verify your Domain

You can authenticate your domain using any of the below methods:

Self Authentication

  1. From the left panel, click on Mail Agents and select a Mail Agent where you want to add or verify your domain.
  2. To add a new domain to the Mail Agent, click on Add Domain.

  1. Enter Domain Name and click on Add. The new domain along with its Verification Status will be displayed below your existing domain.

  1. Click on Verify Domain across the domain to view SPF and DKIM configuration details.
  2. Copy SPF Record, DKIM Record and CNAME Record and publish them to DNS. Refer here for general instructions to add SPF and DKIM records in the DNS. 

Note:

  • It may take 24-48 hours for the records to be published in the DNS. So your domain will not be verified until that time and you will not be able to send any emails.
  • If you have an already existing SPF TXT record configured for any other service say "v=spf1 include:zoho.com ~all", then you should not create a new SPF TXT record for TransMail. If the new TransMail SPF TXT value is "v=spf1 include:transmail.net ~all", then modify your existing DNS SPF TXT record value to "v=spf1 include:transmail.net include:zoho.com ~all".
  1. After these records are published, click on Verify.

  1. The next step is to add a bounce address for the Mail Agent. Hover on your domain and click on Bounce Settings option on the right side. Enter the Bounce Address and click on Add.

  1. Your new domain is verified successfully.

Authentication with the help of IT administrator

Sometimes you may not be handing your domains. In that case, you can get help from your IT administrator to publish DNS Records. Follow the below steps to share your records:

Follow steps 1 to 3 as above.

  1. Click on Share.

Note:

If you have an already existing SPF TXT record configured for any other service say "v=spf1 include:zoho.com ~all", then you should not create a new SPF TXT record for TransMail. If the new TransMail SPF TXT value is "v=spf1 include:transmail.net ~all", then modify your existing DNS SPF TXT record value to "v=spf1 include:transmail.net include:zoho.com ~all".

    1. You will get an email template pop-up.
    2. You can enter the email address of your IT administrator and all other related email ids who must be notified to get your SPF Record and DKIM Record published to the DNS. Add information in the body text. Click on Send.

    1. After these records are published, click on Verify.

    1. Now follow steps 7 till 10 to set up your bounce address.

    Note:

    It may take 24-48 hours for the records to be published in the DNS. So your domain will not be verified until that time and you will not be able to send any emails.

    Edit your Domain

    In TransMail all your un-verified domains can be edited. To edit your domain, follow the below steps:

    1. From the left panel, click on Mail Agents and select a Mail Agent where you want to edit the domain.
    2. Hover on the domain that is not verified.

    1. Click on Edit icon located next to the domain you wish to edit.

    1. You can now change the domain name to your desired name.

    Delete your Domain

    Only a user with the role Postmaster can delete a verified domain from Mail Agents. If you delete a domain, all the data associated with the domain will also be deleted. You will NOT be able to send any further emails from the deleted domain. If you use a deleted sender domain in your API/ SMTP, it will show an error message. In order to send emails using this domain, you will have to add and verify the domain once again. Follow the below steps to delete a domain:

    1. From the left panel, select the Mail Agent whose associated domain has to be deleted.
    2. Hover on the domain in the listing you want to delete. Click on delete icon on right-hand-side for that domain.

    1. Click on OK to confirm the deletion of the domain. The domain will be deleted.

    DNS Record Summary

    Domain verification typePurposeRecord typeHostValue
    SPF*Domain verificationTXT@/ subdomain namev=spf1 include:transmail.net ~all
    DKIM*TXT<selector>._domainkey.subdomainFind this value under Domains tab, while verifying a domain in your TransMail Mail Agent.
    CNAME*To configure bounce addressCNAMEsubdomain nameFind this value in the Domain Verification tab, while configuring your domain. 
    CNAMETo enable email trackingCNAMEsubdomain nameFind this value under the Email tracking tab, while verifying the tracking domain. 

    * - mandatory DNS records

    Note:

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

    Note:

    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 email provider, you can visit Zoho Campaigns.