Api Gateway -> Lambda (Send Email) -> SES (Simple Email Service)

Description

This is a serverless component consisting of:

• an Api Gateway with a POST /send endpoint, that requires three parameters:

  • toEmails, Array of strings, that represent all the emails you want to send an email to,
  • subject, a string representing the subject of the email
  • message, a string representing the message of the email, can be either HTML or regular text It also accepts two optional ones: ccEmails and replyToEmails, both of Array of strings type.

• a Lambda that sends an email to one or more specified email addresses. Also, depending if the message is in a Text or HTML format, it will send it in either of those formats. The toEmails,ccEmails, and replyToEmails parameters must be of Array type.

It's a Nuts & Bolts application component for AWS Serverless Application Repository.

Deployment Parameters

This component has two CloudFormation deployment parameters:

• FromEmail, a required parameter, represents the email sender. Must be a SES verified email. If you attempt to send email using a non-verified address or domain, the operation results in an "Email address not verified" error.
• CorsOrigin, an optional parameter, where you can restrict access to only specified domains.

Latest Release - 1.1.0

• Upgrade to Node.js 12.x LTS

Roadmap - Upcoming changes

Here are the upcoming changes that I'll add to this serverless component:

• ESLint
• Tests

Building locally

Install and use the SAM CLI to build on your local.

sam build

Running locally

After building locally you can run the API using the following command:

sam local start-api --debug --env-vars local/env.json

Env Overrides

You can set env variables for your local environment. Sample content for local/env.json:

{
    "LambdaEmailer": {
      "FROM_EMAIL": "[email protected]",
      "DESTINATION_MAPPING": "{\"abc123\": \"[email protected]\"}"
    }
  }

Testing Locally

Once your local API is running you can test it using curl. Sample command:

curl -iX POST -H 'Content-type: application/json' http://127.0.0.1:3000/send -d '{"subject":"SUBJECT","message":"MSG", "toEmails":["abc123"]}'