Sample code for 30+ languages & platforms
CkJava

Amazon SES v2: Send private appointment reminders and inspect each result

See more Amazon SES Examples

Replace the two recipients with test mailboxes you control. The example supplies an inline template and one private destination per entry. Store each successful message ID against its appointment. Schedule a retry with backoff only for entries with a retryable outcome. Correct permanent errors before resubmission.

SendBulkEmail · Per-entry outcomes

Chilkat CkJava Downloads

CkJava
import com.chilkatsoft.*;

public class ChilkatExample {

  static {
    try {
        System.loadLibrary("chilkat");
    } catch (UnsatisfiedLinkError e) {
      System.err.println("Native code library failed to load.\n" + e);
      System.exit(1);
    }
  }

  public static void main(String argv[])
  {
    boolean success = false;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    success = false;

    CkJsonObject request = new CkJsonObject();
    request.UpdateString("FromEmailAddress","sender@example.com");
    request.UpdateString("DefaultContent.Template.TemplateContent.Subject","Appointment reminder");
    request.UpdateString("DefaultContent.Template.TemplateContent.Text","Hello {{name}}, your appointment is {{slot}}.");
    request.UpdateString("DefaultContent.Template.TemplateData","{\"name\":\"there\",\"slot\":\"in your booking confirmation\"}");

    CkJsonObject firstReminder = new CkJsonObject();
    firstReminder.UpdateString("name","Avery");
    firstReminder.UpdateString("slot","Tuesday at 9 AM Central");
    request.UpdateString("BulkEmailEntries[0].Destination.ToAddresses[0]","avery@example.com");
    request.UpdateString("BulkEmailEntries[0].ReplacementEmailContent.ReplacementTemplate.ReplacementTemplateData",firstReminder.emit());

    CkJsonObject secondReminder = new CkJsonObject();
    secondReminder.UpdateString("name","Robin");
    secondReminder.UpdateString("slot","Wednesday at 2 PM Central");
    request.UpdateString("BulkEmailEntries[1].Destination.ToAddresses[0]","robin@example.com");
    request.UpdateString("BulkEmailEntries[1].ReplacementEmailContent.ReplacementTemplate.ReplacementTemplateData",secondReminder.emit());
    //  Use the same AWS Region for the identity, endpoint, and Signature Version 4.
    String region = "us-west-2";
    CkStringBuilder host = new CkStringBuilder();
    host.Append("email.");
    host.Append(region);
    host.Append(".amazonaws.com");

    CkAuthAws signer = new CkAuthAws();
    //  Supply the credentials from your application's credential provider.
    signer.put_AccessKey("AWS_ACCESS_KEY_ID");
    signer.put_SecretKey("AWS_SECRET_ACCESS_KEY");
    signer.put_Region(region);
    signer.put_ServiceName("ses");

    CkSocket connection = new CkSocket();
    connection.put_RequireSslCertVerify(true);
    success = connection.Connect(host.getAsString(),443,true,10000);
    if (success != true) {
        System.out.println(connection.lastErrorText());
        return;
        }

    CkRest rest = new CkRest();
    success = rest.UseConnection(connection,false);
    if (success != true) {
        System.out.println(rest.lastErrorText());
        return;
        }

    success = rest.SetAuthAws(signer);
    if (success != true) {
        System.out.println(rest.lastErrorText());
        return;
        }

    //  For temporary AWS credentials, supply the session token from the same provider.
    String sessionToken = "";
    if (sessionToken != "") {
        rest.AddQueryParam("X-Amz-Security-Token",sessionToken);
        }

    rest.AddHeader("Content-Type","application/json");
    String responseText = rest.fullRequestString("POST","/v2/email/outbound-bulk-emails",request.emit());
    if (rest.get_LastMethodSuccess() != true) {
        System.out.println(rest.lastErrorText());
        return;
        }

    if (rest.get_ResponseStatusCode() != 200) {
        System.out.println("SES returned HTTP " + rest.get_ResponseStatusCode() + " " + responseText);
        return;
        }

    CkJsonObject response = new CkJsonObject();
    success = response.Load(responseText);
    if (success != true) {
        System.out.println(response.lastErrorText());
        return;
        }

    int count = response.SizeOfArray("BulkEmailEntryResults");
    if (count != request.SizeOfArray("BulkEmailEntries")) {
        System.out.println("Incomplete results. Reconcile the original batch before retrying.");
        return;
        }

    int i = 0;
    while ((i < count)) {
        response.put_I(i);
        request.put_I(i);
        String recipient = request.stringOf("BulkEmailEntries[i].Destination.ToAddresses[0]");
        String status = response.stringOf("BulkEmailEntryResults[i].Status");
        if (status == "SUCCESS") {
            System.out.println(recipient + " accepted: " + response.stringOf("BulkEmailEntryResults[i].MessageId"));
            }
        else {
            if ((status == "ACCOUNT_THROTTLED") || (status == "TRANSIENT_FAILURE")) {
                System.out.println(recipient + " retry later: " + status);
                }
            else {
                System.out.println(recipient + " review before retry: " + status + " " + response.stringOf("BulkEmailEntryResults[i].Error"));
                }

            }

        i = i+1;
        }
  }
}