Sample code for 30+ languages & platforms
Delphi DLL

Amazon SES v2: Send a newsletter with an SES-managed topic unsubscribe link

See more Amazon SES Examples

Use an existing SES contact list named Readers with a ProductUpdates topic and a test subscriber who opted in. Replace the verified sender and subscriber address. Send to one recipient per message so SES can insert its subscription headers and personalize the footer link. When that reader opts out, SES honors the preference on future sends using the same list and topic.

SES subscription management · SendEmail

Chilkat Delphi DLL Downloads

Delphi DLL
var
success: Boolean;
request: HCkJsonObject;
region: PWideChar;
host: HCkStringBuilder;
signer: HCkAuthAws;
connection: HCkSocket;
rest: HCkRest;
sessionToken: PWideChar;
responseText: PWideChar;
response: HCkJsonObject;

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,'Destination.ToAddresses[0]','subscriber@example.com');
CkJsonObject_UpdateString(request,'ListManagementOptions.ContactListName','Readers');
CkJsonObject_UpdateString(request,'ListManagementOptions.TopicName','ProductUpdates');
CkJsonObject_UpdateString(request,'Content.Simple.Subject.Data','Product updates: November edition');
CkJsonObject_UpdateString(request,'Content.Simple.Body.Text.Data','The November catalog is available.' + #10 + 'Manage your preferences: {{amazonSESUnsubscribeUrl}}');
CkJsonObject_UpdateString(request,'Content.Simple.Body.Html.Data','<p>The November catalog is available.</p><p><a href="{{amazonSESUnsubscribeUrl}}">Manage your product update preferences</a></p>');
//  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-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;
Memo1.Lines.Add('SES accepted the message: ' + CkJsonObject__stringOf(response,'MessageId'));

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