Introduction
Channels
Templates
Contacts
Messages
API
public
beta
Docs Contact Login

ses Amazon SES

Amazon SES is definitely most affordable Email Service Provider, starting at $0.1 / 1,000 emails.

Signup at: https://aws.amazon.com/ses/

Features

Webhooks events Common ESP features
Delivered CC addresses
Dropped BCC addresses
Soft bounced ReplyTo address
Opened Tags / Categories
Clicked Test / Sandbox mode
Unsubscribed Campaigns allowed
Spam
Amazon SES specific features
ReturnPath address Bounces and complaints are forwarded to this email address.

Connect Amazon SES

To connect Amazon SES with Notifuse you need: an Access Key ID, it's Secret Access Key and the region name of your SES domain.

Login into your AWS account and create a new IAM role to get an SES Access Key.

If you never used Amazon SES before, don't forget get out of the SES sandbox!

Connect SES's webhooks

  1. Grab your Notifuse webhooks URL from your SES's channel settings.
  2. Connect to your AWS Console and go to SNS.
  3. Create a new topic named "notifuse".
  4. Create a new subscription for this Topic, select the protocol "HTTPS" and paste your Notifuse webhooks URL.
  5. Go to the SES console, and select the email address you want to setup.
  6. In the "Notifications" section, click "Edit configuration".
  7. Select your "notifuse" Topic for the "Bounces", "Complaints" and "Deliveries" events.

Available settings

The Amazon SES settings are defined at the template level from the Notifuse interface when you create/update a template.

If you don't plan to create your templates via API, or overwrite some settings at the last minute when you send a message (via API), you can skip the following table.

However it can be useful to overwrite some settings when you send a message from the API, like the email parameter to route an email to the secondary email address of the recipient (imagine he forgot his password and cannot reach his primary mailbox).

The settings you can overwrite when you send a message via API are marked in the Available in column.
Parameter Expected value Available in Description
email
required
string contact, message Email address of the recipient. Has to exist in the recipients contact profiles.
from
required
string template, message Email address of the sender.
subject
required
string template, message Subject of your email. Templating markup allowed.
text
required if no html
string template Text content of your email. Templating markup allowed.
textMacro
optional
string template Id of the page of macros used in the text content of your email.
html
required if no text
string template HTML content of your email. Templating markup allowed.
htmlMacro
optional
string template Id of the page of macros used in the html content of your email.
testData
optional
object template JSON object of fake data used to test your templates.
cc
optional
array template, message Array of email addresses to CC.
bcc
optional
array template, message Array of email addresses to BCC.
replyTo
optional
array of strings template, message Array of email addresses where you want to receive replies of your emails.
returnPath
optional
string: email message Email address where you want the bounces and complaints to be forwarded to.
returnPathArn
optional
string message Optional ARN of the specified returnPath email address.
fromArn
optional
string message Optional ARN of the specified from email address.

Next: How to use the templates ยป