Amazon SES

Amazon SES is a component of Amazon Web Services which provides a way to send and receive email in response to events in your app. To use it, you need:

  • A MongoDB Stitch app with at least one user.
  • An Amazon AWS account with permission to use the SES service.
  • At least one verified email address.

Set up SES

  1. Log in at the Amazon AWS console.

    Amazon recommends that you set up an IAM (Identity and Access Management) user for running AWS services, rather than running services as your root AWS user, and grant that user only the permissions necessary to run the services you need. See Amazon’s documentation for more information about IAM users.

  2. Navigate to the SES dashboard through the Services menu in the top left of the AWS console.

  3. Verify at least one email address in the Email Addresses area.

Add an SES Service to Your App

  1. If you don’t have a MongoDB Stitch app set up yet, see Getting Started.
  2. If your app doesn’t have an SES service yet, click Add Service in the left side navigation.
  3. Select SES.
  4. Enter a name for your service in the Service Name box.
  5. Click Add Service.
  6. Enter your AWS credentials. Make sure the region matches the region your AWS user is registered with.
  7. Click Save.

Pipelines and Amazon SES Service

MongoDB Stitch provides the ability to define a sequence of actions to perform as a pipeline. For the Amazon SES service, MongoDB Stitch provides the following actions:

Action Description
send Sends an email message to a specified address.


A pipeline can consist of stages that use different MongoDB Stitch services.

Test Your Address with the Debug Console

  1. In the MongoDB Stitch admin console, click Debug Console in the left side navigation.

  2. Click choose user… near the top of the page. Make sure the app user’s email address is verified with Amazon SES (see above).

  3. In the Pipeline to execute: section, select your app’s SES service from the Service dropdown menu.

  4. Select send from the Action dropdown menu.

  5. Add the following document to the Arguments input box. Fill in the JSON values appropriately.

      "toAddress": "",
      "body": "test message",
      "fromAddress": "",
      "subject": "test subject"
  6. Click Execute. The result should be an empty array.

      "result": []
  7. Check the recipient’s inbox.


    The message is sent by Amazon SES. Depending on your email provider’s policies and your SES setup, the message’s From address may not match the sender’s idetity. Check your junk mail folder if you don’t see the message in your inbox.

←   Amazon S3 GitHub Service  →