Sample code for 30+ languages & platforms
Objective-C

Amazon SES v2: Send a raw MIME email with a PDF attachment

See more Amazon SES Examples

Place invoice.pdf in the working directory. Chilkat builds the MIME message and gives the attachment the name invoice-1042.pdf. The v2 SendEmail request carries those bytes in Content.Raw.Data. For a blind copy, supply the address in Destination.BccAddresses and keep it out of the MIME headers.

Use a verified sender and grant ses:SendEmail for this v2 operation. The v2 message size limit is 40 MB including attachments after MIME encoding. For a straightforward attachment that needs no custom MIME layout, v2 also supports Content.Simple.Attachments.

Sending raw email · SES attachments · Sending quotas

Chilkat Objective-C Downloads

Objective-C
#import <CkoBinData.h>
#import <NSString.h>
#import <CkoEmail.h>
#import <CkoJsonObject.h>
#import <CkoStringBuilder.h>
#import <CkoAuthAws.h>
#import <CkoSocket.h>
#import <CkoRest.h>

BOOL success = NO;

//  Assumes Chilkat is unlocked. See Global Unlock Sample.

success = NO;

//  Read the PDF before making a network request.
CkoBinData *pdf = [[CkoBinData alloc] init];
success = [pdf LoadFile: @"invoice.pdf"];
if (success != YES) {
    NSLog(@"%@",pdf.LastErrorText);
    return;
}

if ([pdf.NumBytes intValue] == 0) {
    NSLog(@"%@",@"invoice.pdf is empty.");
    return;
}

NSString *sender = @"sender+reports@example.com";
NSString *recipient = @"success@simulator.amazonses.com";
CkoEmail *email = [[CkoEmail alloc] init];
email.From = sender;
email.Subject = @"Invoice 1042";
email.Charset = @"utf-8";
success = [email AddTo: @"" emailAddress: recipient];
if (success != YES) {
    NSLog(@"%@",email.LastErrorText);
    return;
}

[email AddPlainTextAlternativeBody: @"Invoice 1042 is attached."];
[email AddHtmlAlternativeBody: @"<p>Invoice <strong>1042</strong> is attached.</p>"];
success = [email AddAttachmentBd: @"invoice-1042.pdf" binData: pdf contentType: @"application/pdf"];
if (success != YES) {
    NSLog(@"%@",email.LastErrorText);
    return;
}

//  Get the exact MIME bytes, including the attachment's transfer encoding.
CkoBinData *mime = [[CkoBinData alloc] init];
success = [email GetMimeBd: mime];
if (success != YES) {
    NSLog(@"%@",email.LastErrorText);
    return;
}

//  Base64 here transports the entire MIME message as a blob in the JSON request.
CkoJsonObject *request = [[CkoJsonObject alloc] init];
[request UpdateString: @"FromEmailAddress" value: sender];
[request UpdateString: @"Destination.ToAddresses[0]" value: recipient];
[request UpdateString: @"Content.Raw.Data" value: [mime GetEncoded: @"base64"]];

//  Use the same AWS Region for the identity, endpoint, and Signature Version 4.
NSString *region = @"us-west-2";
CkoStringBuilder *host = [[CkoStringBuilder alloc] init];
[host Append: @"email."];
[host Append: region];
[host Append: @".amazonaws.com"];

CkoAuthAws *signer = [[CkoAuthAws alloc] init];
//  Supply the credentials from your application's credential provider.
signer.AccessKey = @"AWS_ACCESS_KEY_ID";
signer.SecretKey = @"AWS_SECRET_ACCESS_KEY";
signer.Region = region;
signer.ServiceName = @"ses";

CkoSocket *connection = [[CkoSocket alloc] init];
connection.RequireSslCertVerify = YES;
success = [connection Connect: [host GetAsString] port: [NSNumber numberWithInt: 443] ssl: YES maxWaitMs: [NSNumber numberWithInt: 10000]];
if (success != YES) {
    NSLog(@"%@",connection.LastErrorText);
    return;
}

CkoRest *rest = [[CkoRest alloc] init];
success = [rest UseConnection: connection autoReconnect: NO];
if (success != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

success = [rest SetAuthAws: signer];
if (success != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

//  For temporary AWS credentials, supply the session token from the same provider.
NSString *sessionToken = @"";
if (sessionToken != @"") {
    [rest AddQueryParam: @"X-Amz-Security-Token" value: sessionToken];
}

[rest AddHeader: @"Content-Type" value: @"application/json"];
NSString *responseText = [rest FullRequestString: @"POST" uriPath: @"/v2/email/outbound-emails" bodyText: [request Emit]];
if (rest.LastMethodSuccess != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

if ([rest.ResponseStatusCode intValue] != 200) {
    NSLog(@"%@%d%@%@",@"SES returned HTTP ",[rest.ResponseStatusCode intValue],@" ",responseText);
    return;
}

CkoJsonObject *result = [[CkoJsonObject alloc] init];
success = [result Load: responseText];
if (success != YES) {
    NSLog(@"%@",result.LastErrorText);
    return;
}

if ([result HasMember: @"MessageId"] != YES) {
    NSLog(@"%@",@"SES returned no message ID.");
    return;
}

NSLog(@"%@%@",@"SES accepted the message. Message ID: ",[result StringOf: @"MessageId"]);