Amazon Simple Email Service

CleverTap supports sending emails through Amazon SES.

Integrating Amazon SES with CleverTap

To integrate Amazon SES with CleverTap, follow the steps below:

  1. In the dashboard, navigate to Settings and click on Integrate Email.
  2. Select Amazon SES.
  3. Navigate to Server Name and Port values should be grabbed from your Amazon SES > Dashboard > SMTP Settings.
  4. Username and Password values should match your SMTP credentials from Amazon SES. These are not your AWS account credentials.
  5. From Address should have one of the values from Amazon SES > Dashboard > Verified Senders > Email addresses list. Most people will not open an email unless they recognize the sender.
  6. Save your settings.
  7. Click Send a test email and fill in your details to test the configuration details you entered. Has it arrived in your inbox? If not, refer to the troubleshooting steps below.

Enabling Bounce and Complaint Processing

When an email is classified as bounced, CleverTap needs to be notified so that no further deliveries to that mailbox are attempted. This is considered a good practice and helps improve your sender reputation.

To enable support for bounce processing, follow the steps below:

  1. Navigate to Amazon SNS.
  2. Create a Topic.
  3. Select the Topic and navigate to Actions > Subscribe to Topic.
  4. Select HTTPS as the Protocol.
  5. As the Endpoint value, add the Callback URL as shown in your CleverTap Email page.
  1. Save your settings by clicking on Create Subscription.
  2. Navigate to Amazon SES.
  3. Select the Email Address you had previously added to the CleverTap Dashboard.
  4. Click on View Details.
  5. Click on Notifications > Edit Configuration.
  1. Under SNS Topic Configuration, select the topics you created earlier such as Bounces, Complaints, and Deliveries by clicking on the Include original headers checkboxes.
  1. Save the configuration.

Handling Unsubscribe Requests

To handle unsubscribed requests from users, refer to the steps in Handling Unsubscribes.


The following explains some troubleshooting scenarios:

  • Sandbox mode: If you’re getting an Invalid Credentials message when saving your settings, it could be that your Amazon SES account is a sandboxed one. You need a valid production-ready Amazon SES account to save your credentials.
  • Spam: Check your Spam folder to see if the message has been classified as Spam by your email provider.
  • Email rendering: If your email does not render properly, check the subject line for newline characters or too many additional spaces. Amazon SES email converts data from UTF-8 format to a 7-bit ASCII format before sending it out. The next line characters or additional spaces may interfere with this conversion.