Sample code for 30+ languages & platforms
Delphi DLL

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 Delphi DLL Downloads

Delphi DLL
var
success: Boolean;
request: HCkJsonObject;
firstReminder: HCkJsonObject;
secondReminder: HCkJsonObject;
region: PWideChar;
host: HCkStringBuilder;
signer: HCkAuthAws;
connection: HCkSocket;
rest: HCkRest;
sessionToken: PWideChar;
responseText: PWideChar;
response: HCkJsonObject;
count: Integer;
i: Integer;
recipient: PWideChar;
status: PWideChar;

begin
success := False;

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

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

firstReminder := CkJsonObject_Create();
CkJsonObject_UpdateString(firstReminder,'name','Avery');
CkJsonObject_UpdateString(firstReminder,'slot','Tuesday at 9 AM Central');
CkJsonObject_UpdateString(request,'BulkEmailEntries[0].Destination.ToAddresses[0]','avery@example.com');
CkJsonObject_UpdateString(request,'BulkEmailEntries[0].ReplacementEmailContent.ReplacementTemplate.ReplacementTemplateData',CkJsonObject__emit(firstReminder));

secondReminder := CkJsonObject_Create();
CkJsonObject_UpdateString(secondReminder,'name','Robin');
CkJsonObject_UpdateString(secondReminder,'slot','Wednesday at 2 PM Central');
CkJsonObject_UpdateString(request,'BulkEmailEntries[1].Destination.ToAddresses[0]','robin@example.com');
CkJsonObject_UpdateString(request,'BulkEmailEntries[1].ReplacementEmailContent.ReplacementTemplate.ReplacementTemplateData',CkJsonObject__emit(secondReminder));
//  Use the same AWS Region for the identity, endpoint, and Signature Version 4.
region := 'us-west-2';
host := CkStringBuilder_Create();
CkStringBuilder_Append(host,'email.');
CkStringBuilder_Append(host,region);
CkStringBuilder_Append(host,'.amazonaws.com');

signer := CkAuthAws_Create();
//  Supply the credentials from your application's credential provider.
CkAuthAws_putAccessKey(signer,'AWS_ACCESS_KEY_ID');
CkAuthAws_putSecretKey(signer,'AWS_SECRET_ACCESS_KEY');
CkAuthAws_putRegion(signer,region);
CkAuthAws_putServiceName(signer,'ses');

connection := CkSocket_Create();
CkSocket_putRequireSslCertVerify(connection,True);
success := CkSocket_Connect(connection,CkStringBuilder__getAsString(host),443,True,10000);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkSocket__lastErrorText(connection));
    Exit;
  end;

rest := CkRest_Create();
success := CkRest_UseConnection(rest,connection,False);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkRest__lastErrorText(rest));
    Exit;
  end;
success := CkRest_SetAuthAws(rest,signer);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkRest__lastErrorText(rest));
    Exit;
  end;
//  For temporary AWS credentials, supply the session token from the same provider.
sessionToken := '';
if (sessionToken <> '') then
  begin
    CkRest_AddQueryParam(rest,'X-Amz-Security-Token',sessionToken);
  end;

CkRest_AddHeader(rest,'Content-Type','application/json');
responseText := CkRest__fullRequestString(rest,'POST','/v2/email/outbound-bulk-emails',CkJsonObject__emit(request));
if (CkRest_getLastMethodSuccess(rest) <> True) then
  begin
    Memo1.Lines.Add(CkRest__lastErrorText(rest));
    Exit;
  end;
if (CkRest_getResponseStatusCode(rest) <> 200) then
  begin
    Memo1.Lines.Add('SES returned HTTP ' + IntToStr(CkRest_getResponseStatusCode(rest)) + ' ' + responseText);
    Exit;
  end;
response := CkJsonObject_Create();
success := CkJsonObject_Load(response,responseText);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkJsonObject__lastErrorText(response));
    Exit;
  end;
count := CkJsonObject_SizeOfArray(response,'BulkEmailEntryResults');
if (count <> CkJsonObject_SizeOfArray(request,'BulkEmailEntries')) then
  begin
    Memo1.Lines.Add('Incomplete results. Reconcile the original batch before retrying.');
    Exit;
  end;
i := 0;
while (i < count) do
  begin
    CkJsonObject_putI(response,i);
    CkJsonObject_putI(request,i);
    recipient := CkJsonObject__stringOf(request,'BulkEmailEntries[i].Destination.ToAddresses[0]');
    status := CkJsonObject__stringOf(response,'BulkEmailEntryResults[i].Status');
    if (status = 'SUCCESS') then
      begin
        Memo1.Lines.Add(recipient + ' accepted: ' + CkJsonObject__stringOf(response,'BulkEmailEntryResults[i].MessageId'));
      end
    else
      begin
        if ((status = 'ACCOUNT_THROTTLED') or (status = 'TRANSIENT_FAILURE')) then
          begin
            Memo1.Lines.Add(recipient + ' retry later: ' + status);
          end
        else
          begin
            Memo1.Lines.Add(recipient + ' review before retry: ' + status + ' ' + CkJsonObject__stringOf(response,'BulkEmailEntryResults[i].Error'));
          end;
      end;
    i := i + 1;
  end;

CkJsonObject_Dispose(request);
CkJsonObject_Dispose(firstReminder);
CkJsonObject_Dispose(secondReminder);
CkStringBuilder_Dispose(host);
CkAuthAws_Dispose(signer);
CkSocket_Dispose(connection);
CkRest_Dispose(rest);
CkJsonObject_Dispose(response);