Address Lists

To create and populate an Address List:

1. Open the SES console at https://console.aws.amazon.com/ses/.

2. In the navigation pane under Mail Manager, choose Address Lists.

3. Choose Create address list and enter a name in the Address list name field.

4. Select either Manual entry or Bulk upload and follow the respective steps:

5. For manual entry – Enter one or more email addresses or domains in the console.

   If you use the asterisk (*) wildcard, the following formats apply:

   1. Only one * is allowed in the address:

      • The * should be either before or after @ when the entry is an email address.

      • When * is in the local part, the local part can be zero or 3 to 19 characters excluding the *.

      • When * is in the domain, the subdomain level can be 2 to 9 excluding the *.

   2. Examples of valid wildcard formats:

      • *.domain1.com to *.domain8.domain7...domain1.com

      • *@domain.com

      • 123*@domain.com to 1234567890123456789*@domain.com

      • local@*.domain1.com to local@*.domain8.domain7...domain1.com

6. For bulk upload – Select Choose file and choose a CSV or JSON file from your computer containing the addresses to be uploaded.

   Use the format shown in the example for each file type:

   1. CSV file example (Note that the header, address, is required.):

      address
      user1@domain.com
      user2@*.domain.com
      *@domain.com

   2. JSON file example:

      {
        "items": [
          {
            "address": "user1@domain.com"
          },
          {
            "address": "user2@*.domain.com"
          },
          {
            "address": "*@domain.com"
          }
        ]
      }

7. Once you've finished adding addresses or have selected a bulk file, choose Create address list.

To update an Address List:

1. On the Address Lists page, select the name of the Address List you want to edit.

2. To add addresses, choose Add email address and proceed with either the manual entry or bulk upload method as explained in Creating & populating an Address List.

3. To remove addresses, select the checkbox next to each address you want to remove followed by Remove email address and confirm deletion.

4. (Optional) Add or remove Tags to your Address List by choosing Manage tags.

• On the Address Lists page, select the name of an Address List to view its details.

1. On the Address Lists page, select the radio button next to the Address List you want to delete followed by Delete.

2. Confirm deletion of the list by typing confirm followed by Delete.

To use an Address List in a traffic policy statement:

1. Create a new traffic policy or edit an existing one as explained in Creating traffic policies & policy statements (console)

2. In the Policy statement container, choose Allow for the action to be taken when the statement's conditions are met.

3. Build the statement's condition as follows:

   • Select Recipient address for the Protocol field.

   • Select Is in address list for the Operator field.

   • Select the name of your Address List for the Value field.

4. While this is just one example, you can add more policy conditions that can be based on a variety of operators with any of your Address Lists.

To use an Address List in a rule condition:

1. Create a new rule or edit an existing one as explained in Creating rule sets & rules (console)

2. In the Rule conditions container, build the rule's condition as follows.

   • Select Recipient address for the Select property field.

   • Select Is in address list for the Select operator field.

   • Select the name of your Address List for the Value field.

3. In the Actions container choose Add new action and select Drop action.

4. While this is just one example, you can add more rule conditions that can be based on a variety of operators with any of your Address Lists for a variety of actions to be taken.