Java

SES Send Plain-Text Email

See more Amazon SES Examples

Sends a simple plain-text email to one or more recipients.

See SES SendEmail for more information.

Chilkat2 Java

import com.chilkatsoft.chilkat2.AuthAws;
import com.chilkatsoft.chilkat2.ChilkatException;
import com.chilkatsoft.chilkat2.Rest;
import com.chilkatsoft.chilkat2.Xml;

public class ChilkatExample {

    public static void main(String[] args) {
        // This example requires the Chilkat API to have been previously unlocked.
        // See Global Unlock Sample for sample code.

        Rest rest = new Rest();

        // Connect to the Amazon AWS REST server.
        // such as https://email.us-west-2.amazonaws.com/
        boolean bTls = true;
        int port = 443;
        boolean bAutoReconnect = true;
        rest.connect("email.us-west-2.amazonaws.com", port, bTls, bAutoReconnect);

        // Provide AWS credentials for the REST call.
        AuthAws authAws = new AuthAws();
        authAws.setAccessKey("AWS_ACCESS_KEY");
        authAws.setSecretKey("AWS_SECRET_KEY");
        // the region should match our URL above..
        authAws.setRegion("us-west-2");
        authAws.setServiceName("ses");

        rest.setAuthAws(authAws);

        rest.addQueryParam("Action", "SendEmail");

        rest.addQueryParam("Message.Body.Text.Data", "This is a sample plain-text email.");
        rest.addQueryParam("Message.Body.Text.Charset", "utf-8");

        rest.addQueryParam("Message.Subject.Data", "Sample plain-text SES email");
        rest.addQueryParam("Message.Subject.Charset", "utf-8");

        // Add up to 100 TO, CC, and BCC recipients.
        // If your SES account is still in the sandbox, you also must verify every recipient email address except for the recipients
        // provided by the Amazon SES mailbox simulator. (See http://docs.aws.amazon.com/ses/latest/DeveloperGuide/mailbox-simulator.html)
        rest.addQueryParam("Destination.ToAddresses.member.1", "success@simulator.amazonses.com");
        // Please do not test by sending email to Chilkat (Thanks!)
        // Please do not test by sending email to Chilkat (Thanks!)
        // Please do not test by sending email to Chilkat (Thanks!)
        rest.addQueryParam("Destination.CcAddresses.member.1", "support@chilkatsoft.com");
        rest.addQueryParam("Destination.CcAddresses.member.2", "somebody@yahoo.com");
        rest.addQueryParam("Destination.BccAddresses.member.1", "somebody@gmail.com");

        rest.addQueryParam("Source", "admin@chilkatdownload.com");

        // Because there may be a large amount of data in the query params, use a POST
        // where the params are sent in the body of the HTTP Request.
        String responseXml;
        try {
            responseXml = rest.fullRequestFormUrlEncoded("POST", "/");
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        // A successful response will have a status code equal to 200.
        if (rest.getResponseStatusCode() != 200) {
            System.out.println("response status code = " + rest.getResponseStatusCode());
            System.out.println("response status text = " + rest.getResponseStatusText());
            System.out.println("response header: " + rest.getResponseHeader());
            System.out.println("response body: " + responseXml);
            return;
        }

        // Examine the successful XML response.
        Xml xml = new Xml();
        xml.loadXml(responseXml);
        System.out.println(xml.getXml());

        // To get the MessageId
        System.out.println("MessageId: " + xml.chilkatPath("SendEmailResult|MessageId|*"));

        // A sample successful response:
        // <?xml version="1.0" encoding="utf-8" ?>
        // <SendEmailResponse xmlns="http://ses.amazonaws.com/doc/2010-12-01/">
        //     <SendEmailResult>
        //         <MessageId>010101579081d2c1-043c693f-5a23-4c64-a8c1-66187d3725a0-000000</MessageId>
        //     </SendEmailResult>
        //     <ResponseMetadata>
        //         <RequestId>e2b5b480-8a4e-11e6-85cd-21b1f1f6d432</RequestId>
        //     </ResponseMetadata>
        // </SendEmailResponse>
    }
}