Configure Email Channel

Connector Configuration

Simple Mail Transfer Protocol (SMTP) is a quick and easy way to send, receive, and/or outgoing relay emails from one email server to another. MoEngage allows you to configure any SMTP service of your choosing to send emails from its system. If you do not have an existing SMTP service, we can configure one for you via SendGrid (Please get in touch with MoEngage Sales for pricing). 

Configure one of the following SMTP services by going into Settings -> Channel -> Email -> Connector Config in MoEngage Dashboard. You must fill out 3 sections: SMTP Settings, Unsubscribe Settings, and Bounce & Complaint Settings.



You can add up to 10 connectors in Email Connector Config. Click '+' to add a new connector.


Refer to the following articles for detailed steps on configuring each Email service provider -

Configure Custom Connector

MoEngage can integrate with any SMTP connector for sending email campaigns. You would need to configure the connector, set up the unsubscribe mechanismand optionally track bounces & complaints if your SMTP connector can post these details in the required format (as described later in the article)

Configure Custom SMTP Settings

      • SMTP Host Name: IP Address or server name of the SMTP connector service you are using
      • SMTP Port: This is the SMTP port number of the connector service to which the connection would be established. To avoid the rate limits set by some hosting companies, we recommend using port 587 instead of port 25.
      • SMTP Protocol: You can select the protocol prefix (SSL/TLS) that your connector supports.
      • SMTP Authentication: Select "ON" here if your SMTP connector requires authentication to establish the connection. Then, enter the SMTP credentials in the username and password.  
      • Maximum send rate: This is the maximum number of emails per second that can be accepted by your SMTP connector.

Configure Custom Unsubscribe Settings

  • "MoEngage Tracking" will add your unsubscribe page URL as the email footer - If you'd like to unsubscribe and stop receiving these emails click here.ConfigureCustomUnsubscibeSettings.png
  • Add the callback URL for Unsubscribe Page URL as shown below:

    MoEngage hosts each customer in a different data center; you can find your data center number (value of X) by checking the data center and API endpoint mapping here.

  • Selecting "None" for promotional email campaigns will lead to higher chances of being classified as spam.

Configure Custom Bounce and Complaint Settings

  • Bounce & Complaints Tracking: MoEngage can receive this information in a POST call in the below format to the URL mentioned in your MoEngage Account -> App Settings -> Email Settings -> Connector Configurations -> Custom -> Callback URL




Since we will not have the Campaign ID in case of this callback, we are unable to show the bounce and complaint details in Campaign Analytics for Custom SMTP Connectors.

POST Format - list of JSON. In "event" you can pass "hard_bounce", "soft_bounce" or "spam" for each case.

      		"event": hard_bounce,
                "data": [

You are all set up with connector configurations. You can now click on the "Save" button to test these settings (including credentials etc.) and save them. You can then select Custom SMTP as the default connector in General Settings. 

General Settings

While creating new email campaigns, the settings from General Settings will be used as defaults.  If you choose Email from the standard attribute with the correct connector configuration, we will track global opt-out against this email address.  If you chose a custom email attribute, unsubscribes will need to be handled separately.

MoEngage standard attribute name for email attribute is Email (Standard). This is a standard attribute where the name is provided by MoEngage, and the value is provided by the client.

Positioning of Open Tracking Pixel

MoEngage allows you to position a tracking pixel at the top or bottom of the email body, thereby tracking the open rates of emails sent to your customers. By default, the tracking pixel is at the bottom of the email to ensure high open rates. If you observe clippings in your email then you can select the Place tracking pixel at the top checkbox to keep the tracking pixel at the top of the email body or else you can keep the tracking pixel at the bottom of the email body by selecting Place tracking pixel at the bottom checkbox.

Domain Reputation

MoEngage shows the domain reputation for each unique and verified domain while adding a "from email address" in email settings. For more information, refer to Domain Reputation.


To limit the number of emails sent to users in a certain period, configure frequency capping settings. Do not disturb are quiet hours during which it is advisable not to send any messages to users.  If a message is scheduled to be sent during do-not-disturb hours, you can either discard it or save it for after the do-not-disturb hours. For more information, refer to Frequency Capping and Do Not Disturb.


Was this article helpful?
6 out of 15 found this helpful

How can we improve this article?