​

Introduction

​

Configure SendGrid Account

​

Add Domains in SendGrid

• To set up a domain, refer to How to Set Up Domain Authentication.
• To set up link branding, refer to How to set up link branding.
• To set up reverse DNS for a dedicated IP, refer to How to set up reverse DNS.
• To set up SSL for click tracking domain, refer to Setup SSL for Click Tracking.
• To set up Sign in with Apple, refer to Configuring Sign in with Apple.

​

Create API Keys in SendGrid

​

Configure SendGrid Settings in MoEngage UI

1. Log in to your MoEngage dashboard.
2. Navigate to Settings > Under Channels > Email > Sender Configuration tab> Click Add Sender
3. In the following Add Sender screen, add the following SMTP details as shown below:
   All of the following details are case-sensitive.

   Field	Description
   Sender Name	Enter a sender name.
   SMTP Host Name	Enter smtp.sendgrid.net
   SMTP Port	Enter 587. Port 587 is recommended to avoid rate limits set by some companies.
   SMTP Protocol	Select TLS.
   SMTP Password	Enter the password. This is the API key created above.
   WebApi Key	Enter the key. This is the API key created above.

4. Configure Unsubscribe Settings based on your requirements. For more information, refer to Track Email Unsubscribes.
5. Configure the List unsubscribe email settings based on your requirements. For more information, refer to List Unsubscribe Email.
6. Click Save. The added connector is listed under the Sender configuration tab.
7. Navigate to the General Settings tab.
8. From the Set a default sender drop-down, select the sender you added.
9. From the User Attribute that stores the user’s email address drop-down, select Email (Standard).
10. In the “From” email address(s) field, add the from address. The domain (the part after @) must be a validated one on SendGrid.
11. Save the settings. The “from address” mailbox added above will receive a verification email.
12. Click the confirmation link to validate the same.

​

Configure SendGrid Bounce and Complaint Settings.

1. Copy the URL in the Bounce & Complaint Tracking from email settings.
2. Use the below API to configure event webhook:
   cURL

   curl --location 'https://api.sendgrid.com/v3/user/webhooks/event/settings' \
   --header 'Content-Type: application/json' \
   --header 'Authorization: Bearer API_KEY_GENERATE_ABOVE' \
   --data '{
        "url": "Bounce and Complaint tracking URL from Step 1",
        "enabled": true,
        "group_resubscribe": true,
        "delivered": true,
        "group_unsubscribe": true,
        "spam_report": true,
        "bounce": true,
        "deferred": true,
        "unsubscribe": true,
        "processed": false,
        "open": true,
        "click": true,
        "dropped": true,
        "friendly\_name": "MOE App name"
   }'
   
   To successfully configure the event webhook, make sure to add the following inputs to the API:
   1. Enter the API key obtained from the above Create API Keys from SendGrid section by replacing API_KEY_GENERATE_ABOVE in the API.
   2. Paste the URL obtained from step 1 in the above API, by replacing "Bounce and Complaint tracking URL from Step 1"
   3. Enter your dashboard name, by replacing "MOE App name" in the above API.

​

Test Email Settings

​

Next Steps