Introduction
Overview Getting started
Channels
Overview SendGrid Mailgun Amazon SES Postmark Mailjet Firebase Push Twilio SMS Plivo SMS Slack Webhooks Twitter
Templates
Overview Templating engine Macros
Contacts
Overview Segments
Messages
Overview Send a message
API
Overview Libraries Contacts Messages
Pricing Docs Contact About Login Signup

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 ยป