Creating Amazon SES event destinations - Amazon Simple Email Service

Creating Amazon SES event destinations

Event destinations allow you to publish the following outgoing email tracking actions to other AWS services for monitoring:

  • Sends

  • Rendering failures

  • Rejects

  • Deliveries

  • Hard bounces

  • Complaints

  • Delivery delays

  • Subscriptions

  • Opens

  • Clicks

To learn more about setting up event publishing, see Monitor email sending using Amazon SES event publishing.

Creating an event destination

After you’ve created a configuration set, you have the option to create event destinations for your configuration set which enables event publishing that is triggered on the event types you specify for the event destination. A configuration set can have multiple event destinations with multiple event types defined.

If you haven't created a configuration set, see Creating configuration sets in SES.

The following steps show how to create or add an event destination to a configuration set.

To create or add and event destination using the SES console:
  1. Sign in to the AWS Management Console and open the Amazon SES console at https://console.aws.amazon.com/ses/.

  2. In the navigation pane, under Configuration, choose Configuration sets.

  3. Choose a configuration set's name from the Name column to access its details.

  4. Select the Event destinations tab.

  5. Choose Add destination.

  6. Select event types

    Email sending events are metrics relating to your sending activity that you can measure using Amazon SES. In this step, you select which types of email sending events you would like Amazon SES to publish to your event destination.

    To learn more about event types, see Monitoring your Amazon SES sending activity.

    1. Choose Event types to publish

      • Sending and delivery – to choose event types to publish, select their respective check boxes, or choose Select all to publish all of the event types.

        Event types
        • Sends – the send request was successful and Amazon SES will attempt to deliver the message to the recipient’s mail server.

        • Rendering failures – the email wasn't sent because of a template rendering issue. This event type can occur when template data is missing, or when there is a mismatch between template parameters and data. (This event type only occurs when you send email using the SendTemplatedEmail or SendBulkTemplatedEmail API operations.)

        • Rejects – Amazon SES accepted the email, but determined that it contained a virus and didn’t attempt to deliver it to the recipient’s mail server.

        • Deliveries – Amazon SES successfully delivered the email to the recipient's mail server.

        • Hard bounces – the recipient's mail server permanently rejected the email. (Soft bounces are only included when Amazon SES fails to deliver the email after retrying for a period of time.)

        • Complaints – the email was successfully delivered to the recipient’s mail server, but the recipient marked it as spam.

        • Delivery delays – the email couldn't be delivered to the recipient’s mail server because a temporary issue occurred. Delivery delays can occur, for example, when the recipient's inbox is full, or when the receiving email server experiences a transient issue. (This event type not supported by Amazon Pinpoint.)

        • Subscriptions – the email was successfully delivered, but the recipient updated the subscription preferences by clicking List-Unsubscribe in the email header or the Unsubscribe link in the footer. (This event type not supported by Amazon Pinpoint.)

      • Open and click tracking – to measure subscriber engagement, choose one or both of the check boxes to track Opens and Clicks.

        • Opens – the recipient received the message and opened it in their email client.

        • Clicks – the recipient clicked one or more links in the email.

          Note

          Open and click event publishing defined here, or in any other configuration set, does not affect engagement tracking options for Virtual Deliverability Manager dashboard; these are defined through either Virtual Deliverability Manager's account settings or configuration set overrides. For example, if you have engagement tracking disabled through Virtual Deliverability Manager, it will not disable the open and click event publishing you have set up here in SES event destinations.

        • Configuration set redirect domain – this field will appear and be prepopulated with the name of the custom redirect domain if you assigned one when creating the configuration set.

          Note

          You can update the Custom redirect domain in the configuration set for open and click tracking under that domain—see Tracking options in Step 4 of Create configuration sets. For more information about configuring custom open and click domains see Configuring custom domains to handle open and click tracking.

    2. Choose Next to continue.

  7. Specify destination

    An event destination is an AWS service to which email sending events can be published. Choosing the appropriate destination depends on the level of detail you want to capture and how you want to receive the data.

    1. Destination options
      • Destination type – when you select the radio button next to the AWS service to publish your events to, a details panel will appear with fields respective to the service. Selecting the links below will give instructions about the service's detail panel:

        • Amazon Pinpoint (Does not support Delivery delays or Subscriptions event types.)

        To learn more about using the event publishing model to monitor your email operation, see Monitor email sending using Amazon SES event publishing.

      • Name – enter the name of the destination for this configuration set. The name can include letters, numbers, dashes, and hyphens.

      • Event publishing – to turn on event publishing for this destination, select the Enabled check box.

    2. Choose Next to continue.

  8. Review

    When you are satisfied that your entries are correct, choose Add destination to add your event destination.

You can also create an event destination using the Amazon SES console, the Amazon SES API v2, or the Amazon SES CLI v2.

To create an event destination using the SES API:

Editing, disabling/enabling, or deleting an event destination

Follow these steps to edit, disable/enable, or delete an event destination using the SES console:

To edit, disable/enable, or delete an event destination using the SES console:
  1. Sign in to the AWS Management Console and open the Amazon SES console at https://console.aws.amazon.com/ses/.

  2. In the navigation pane, under Configuration, choose Configuration sets.

  3. Choose a configuration set's name from the Name column to access its details.

  4. Select the configuration set's Event destinations tab.

  5. Select the event destination's name under the Name column.

    • To edit – Choose the Edit button on the respective panel for the set of fields you want to edit and make your changes followed by Save changes.

    • To disable or enable – Choose the button that's either labeled Disable or Enable in the upper-right corner.

    • To delete – Choose the Delete button in the upper-right corner.

You can also edit, disable/enable, or delete an event destination using the Amazon SES console, the Amazon SES API v2, or the Amazon SES CLI v2.

To edit, disable/enable, or delete an event destination using the SES API:
  1. For disabling/enabling an event destination using the SES API, see UpdateConfigurationSetEventDestination.

  2. For deleting an event destination using the SES API, see DeleteConfigurationSetEventDestination.