Skip to main content

Amazon SES Component

Amazon SES

Send Emails through Amazon (AWS) SES

Component key: aws-ses

Description​

Amazon SES is a service that enables developers to send mail from within any application. The Amazon SES component allows you to list identities, and send emails to those identities.

You must validate email addresses or domains

Before you can send an email using Amazon SES, you must verify that you are the owner of the email address or domain that you want to send email from. You can do that from the SES admin page on the AWS console.

Connections​

AWS SES Access Key and Secret​

An AWS IAM access key pair is required to interact with Amazon SES. Make sure that the key pair you generate in AWS has proper permissions to the SES resources you want to access. Read about Amazon SES IAM policies in the AWS docs.

AWS Role ARN​

To enable the IAM role authentication begin by logging into the AWS Console and navigate to Identity and Access Management (IAM).

To create a user and generate credentials:

  1. Navigate to Users and select Create User.
  • Provide a User name and check the box providing them user access to the AWS Managment Console if needed.
  • Once completed with the User creation, copy the ARN provided in the summary for a later step.

  1. To obtain the ARN for an existing User, click on the designated username from the Users page and the ARN will be provided in the summary section.

  2. From the summary section, select Create access key

  • Select Third-party service as the access key type and select next.
  • Set a description and select create access key.
  • Copy the Access Key and Secret access key and enter those into the connection configuration of your integration along with the ARN.

To create and assign a user a role:

  1. Navigate to Roles and select Create Role.
  • Select Custom Trust Policy for the Trusted entity types
  • Copy the following statement into the statement console. Making sure to replace the ARN with the user's actual ARN from the previous section
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "ARN"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}
  • When adding permissions provide the AmazonSESFullAccess permission
  • Complete remaining steps and select Create Role

Actions​

List Identities​

List Identities available in Amazon SES | key: listIdentities

Output Example Payload​

{
  "data": {
    "$metadata": {
      "httpStatusCode": 200,
      "requestId": "4d41a619-b699-444b-9b09-7edbb92fc867",
      "attempts": 1,
      "totalRetryDelay": 0
    },
    "Identities": [
      "example@example.com"
    ],
    "NextToken": "exampleToken"
  }
}

Send Email​

Send an email through Amazon SES | key: sendEmail

Output Example Payload​

{
  "data": {
    "$metadata": {
      "httpStatusCode": 200,
      "requestId": "00000000-0000-0000-0000-000000000000",
      "attempts": 1,
      "totalRetryDelay": 0
    },
    "MessageId": "0000000000000000-00000000-0000-0000-0000-000000000000-000000"
  }
}