Amazon Simple Email Service
Developer Guide (API Version 2010-12-01)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Go to the Kindle Store to download this guide in Kindle format.Did this page help you?  Yes | No |  Tell us about it...

Appendix: Amazon SES Scripts

Amazon SES provides several Perl scripts for performing various tasks. You can download and run the scripts as they are, modify them, or use them as examples for building your own solutions.


Amazon SES no longer maintains these scripts. For command-line access to Amazon SES, you can use the AWS Command Line Interface or the AWS Tools for Windows PowerShell. To integrate your mail server with Amazon SES, you can use the Amazon SES Simple Mail Transfer Protocol (SMTP) interface. For more information, see Integrating Amazon SES with Your Existing Email Server.

Downloading the Scripts

You can download all of the Amazon SES scripts at Be sure to consult the README file that comes with these scripts, because this file contains important information about how to prepare the scripts for use.

Using Your AWS Credentials

You must provide your AWS credentials whenever you run any of the Amazon SES scripts. Because it is not secure to provide these credentials on the command line, these scripts use an alternative way of accessing your AWS access key ID and secret access key.

To provide an Amazon SES script with your AWS credentials

  1. Create a new text file with the name of your choice—aws-credentials, for example.

  2. Add the following lines to the file, and then save the file. Replace the key values shown with your actual AWS credentials:



  3. Change the permissions on the file so that only you have access. The procedure for this depends on your operating system.


    Nobody else should ever see your secret access key.

After you have created the credential file, you can use these scripts in one of the following ways:

  • Use the -k parameter, followed by the name of your credential file.

  • Set an environment variable named AWS_CREDENTIALS_FILE, whose value is the name of the file containing your AWS credentials. The procedure for this depends on your operating system. Here is an example of how you can do this on a Linux system, using the bash shell:

    export AWS_CREDENTIALS_FILE=aws-credentials