Sample code for 30+ languages & platforms
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 C++ Downloads

C++
#include <CkBinData.h>
#include <CkEmail.h>
#include <CkJsonObject.h>
#include <CkStringBuilder.h>
#include <CkAuthAws.h>
#include <CkSocket.h>
#include <CkRest.h>

void ChilkatSample(void)
    {
    bool success = false;

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

    success = false;

    //  Read the PDF before making a network request.
    CkBinData pdf;
    success = pdf.LoadFile("invoice.pdf");
    if (success != true) {
        std::cout << pdf.lastErrorText() << "\r\n";
        return;
    }

    if (pdf.get_NumBytes() == 0) {
        std::cout << "invoice.pdf is empty." << "\r\n";
        return;
    }

    const char *sender = "sender+reports@example.com";
    const char *recipient = "success@simulator.amazonses.com";
    CkEmail email;
    email.put_From(sender);
    email.put_Subject("Invoice 1042");
    email.put_Charset("utf-8");
    success = email.AddTo("",recipient);
    if (success != true) {
        std::cout << email.lastErrorText() << "\r\n";
        return;
    }

    email.AddPlainTextAlternativeBody("Invoice 1042 is attached.");
    email.AddHtmlAlternativeBody("<p>Invoice <strong>1042</strong> is attached.</p>");
    success = email.AddAttachmentBd("invoice-1042.pdf",pdf,"application/pdf");
    if (success != true) {
        std::cout << email.lastErrorText() << "\r\n";
        return;
    }

    //  Get the exact MIME bytes, including the attachment's transfer encoding.
    CkBinData mime;
    success = email.GetMimeBd(mime);
    if (success != true) {
        std::cout << email.lastErrorText() << "\r\n";
        return;
    }

    //  Base64 here transports the entire MIME message as a blob in the JSON request.
    CkJsonObject request;
    request.UpdateString("FromEmailAddress",sender);
    request.UpdateString("Destination.ToAddresses[0]",recipient);
    request.UpdateString("Content.Raw.Data",mime.getEncoded("base64"));

    //  Use the same AWS Region for the identity, endpoint, and Signature Version 4.
    const char *region = "us-west-2";
    CkStringBuilder host;
    host.Append("email.");
    host.Append(region);
    host.Append(".amazonaws.com");

    CkAuthAws signer;
    //  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;
    connection.put_RequireSslCertVerify(true);
    success = connection.Connect(host.getAsString(),443,true,10000);
    if (success != true) {
        std::cout << connection.lastErrorText() << "\r\n";
        return;
    }

    CkRest rest;
    success = rest.UseConnection(connection,false);
    if (success != true) {
        std::cout << rest.lastErrorText() << "\r\n";
        return;
    }

    success = rest.SetAuthAws(signer);
    if (success != true) {
        std::cout << rest.lastErrorText() << "\r\n";
        return;
    }

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

    rest.AddHeader("Content-Type","application/json");
    const char *responseText = rest.fullRequestString("POST","/v2/email/outbound-emails",request.emit());
    if (rest.get_LastMethodSuccess() != true) {
        std::cout << rest.lastErrorText() << "\r\n";
        return;
    }

    if (rest.get_ResponseStatusCode() != 200) {
        std::cout << "SES returned HTTP " << rest.get_ResponseStatusCode() << " " << responseText << "\r\n";
        return;
    }

    CkJsonObject result;
    success = result.Load(responseText);
    if (success != true) {
        std::cout << result.lastErrorText() << "\r\n";
        return;
    }

    if (result.HasMember("MessageId") != true) {
        std::cout << "SES returned no message ID." << "\r\n";
        return;
    }

    std::cout << "SES accepted the message. Message ID: " << result.stringOf("MessageId") << "\r\n";
    }