Amazon SES Setup Tutorial

Amazon SES Setup Tutorial

Table of Contents:

You may want to first review the general Vendor Settings online help page, prior to following this specific vendor tutorial.

API Credentials

 Following are the steps required to retrieved the API credentials needed to connect your Ongage vendor connection to your Amazon SES account.

  1. Login to Amazon AWS at Cloud Email Sending Service - Amazon Simple Email Service - AWS

    image-20250909-080215.png

     

  2. Enter your username and password 

    image-20250909-080418.png

     

  3. Click 'My Account/Console' and then 'Security Credentials' option

    image-20250909-080811.png


     

  4. Scroll down to “Access Keys” section. Create new if needed.

    image-20250909-081022.png

     Note: Please make sure that Access Key have permission for “GetIdentityDkimAttributes”.

  5. You can only get the secret key when a new key is created. 

    1. You also may have only 2 keys at a given time, both Active and Inactive.

    2. If you already have two keys and you do not know the secret key, you would have to delete one before you create the new one. If you do not have two keys in place, simply create a new one by clicking the ‘Create New Access Key’ button. 

    3. After clicking Create New Access Key button a new window would pop. At this point your key is already created. 

    4. To show the access key and secret key simply click the Show Access Key link. 

    5. Copy the Access Key ID and the Secret Access Key to Ongage platform or download and save in safe place. 

      image-20250909-082026.png


       We also recommend you keep a copy of the secret key in a safe offline place for future reference.
                                                                   

  6. To retrieve your SMTP username and password you would have to login into Amazon AWS as shown in step 1 and 2 above.

  7. Search “Amazon simple Email Service“ and click on it.

    image-20250909-082731.png

     

  8. Click “SMTP Settings” on the left column. Click ‘Create My SMTP Credentials’ button 

    image-20250909-082925.png
  9. Your SMTP has been created successfully. Click the ‘Show User SMTP Security Credentials’ link

    1. Copy the Username and Password to Ongage platform. We also recommend you keep a copy of the secret key in a safe offline place for future reference

      image-20250909-083614.png

Email/Domain Verification Procedures

The following procedures shows how to use the Amazon SES console to verify and view verified sending email addresses.

How to verify a sending email address 

  1. Go to Amazon SES console > Configuration> Identities

  2. Click on Create Identity button> Select Email address

  3. In the Verify a New Email Address dialog box, type your email address in the indicated field, and then choose Verify This Email Address.

    image-20250909-084351.png

     

  4. In your email client, open the message from Amazon SES asking you to confirm that you are the owner of this email address.

  5. Click the link in the message.

    Note: The link in the verification message expires 24 hours after your original verification request.

  6. The status of the email address in the Amazon SES console will change from "pending verification" to "verified".

  7. You can now use Amazon SES to send email from this address. To send a test email, check the box next to the verified email address, and then choose Send a Test Email.

To view your verified email addresses

  1. Go to Configuration> Identities in the Amazon SES console, or follow these instructions to navigate to it:

    1. Sign in to the AWS Management Console and open the Amazon SES console at https://console.aws.amazon.com/ses/home#/identities

    2. In the navigation panel, under Identity Management, choose Email Addresses.

  2. In the list of verified email addresses, you can expand one or more email addresses to view the details.

What's the difference between a verified domain and verified email address 

 To be noted: One can remove the verified email address from the Amazon SES account, so long as the domain is a verified domain and thus it will apply for all email addresses with that domain.

Make sure Feedback forwarding is Enabled

Please make sure that the From Address used in the Amazon SES Connection is a verified domain in Amazon SES with the correct Feedback forwarding flag as shown in the screenshot below.

image-20251202-100450.png

Amazon SES Sandbox Account 

How do I know if my Amazon SES account is a sandbox account

  1. Step 1: Go to Amazon Simple Service > Account Dashboard

    image-20250909-091735.png

About Amazon SES Sandbox Accounts

 Amazon places all new Amazon SES account in "sandbox" access.

While your account is in sandbox, you can use all of the features of Amazon SES. However, the following restriction applies:

  • You can only send mail to verified email addresses and domains, or to the Amazon SES mailbox simulator.

Therefore you'll need to move your Amazon SES account out of Sandbox, and you can refer to the following Link in order to do so: https://docs.aws.amazon.com/ses/latest/dg/request-production-access.html