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

Unicode C
#include <C_CkBinDataW.h>
#include <C_CkEmailW.h>
#include <C_CkJsonObjectW.h>
#include <C_CkStringBuilderW.h>
#include <C_CkAuthAwsW.h>
#include <C_CkSocketW.h>
#include <C_CkRestW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkBinDataW pdf;
    const wchar_t *sender;
    const wchar_t *recipient;
    HCkEmailW email;
    HCkBinDataW mime;
    HCkJsonObjectW request;
    const wchar_t *region;
    HCkStringBuilderW host;
    HCkAuthAwsW signer;
    HCkSocketW connection;
    HCkRestW rest;
    const wchar_t *sessionToken;
    const wchar_t *responseText;
    HCkJsonObjectW result;

    success = FALSE;

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

    success = FALSE;

    //  Read the PDF before making a network request.
    pdf = CkBinDataW_Create();
    success = CkBinDataW_LoadFile(pdf,L"invoice.pdf");
    if (success != TRUE) {
        wprintf(L"%s\n",CkBinDataW_lastErrorText(pdf));
        CkBinDataW_Dispose(pdf);
        return;
    }

    if (CkBinDataW_getNumBytes(pdf) == 0) {
        wprintf(L"invoice.pdf is empty.\n");
        CkBinDataW_Dispose(pdf);
        return;
    }

    sender = L"sender+reports@example.com";
    recipient = L"success@simulator.amazonses.com";
    email = CkEmailW_Create();
    CkEmailW_putFrom(email,sender);
    CkEmailW_putSubject(email,L"Invoice 1042");
    CkEmailW_putCharset(email,L"utf-8");
    success = CkEmailW_AddTo(email,L"",recipient);
    if (success != TRUE) {
        wprintf(L"%s\n",CkEmailW_lastErrorText(email));
        CkBinDataW_Dispose(pdf);
        CkEmailW_Dispose(email);
        return;
    }

    CkEmailW_AddPlainTextAlternativeBody(email,L"Invoice 1042 is attached.");
    CkEmailW_AddHtmlAlternativeBody(email,L"<p>Invoice <strong>1042</strong> is attached.</p>");
    success = CkEmailW_AddAttachmentBd(email,L"invoice-1042.pdf",pdf,L"application/pdf");
    if (success != TRUE) {
        wprintf(L"%s\n",CkEmailW_lastErrorText(email));
        CkBinDataW_Dispose(pdf);
        CkEmailW_Dispose(email);
        return;
    }

    //  Get the exact MIME bytes, including the attachment's transfer encoding.
    mime = CkBinDataW_Create();
    success = CkEmailW_GetMimeBd(email,mime);
    if (success != TRUE) {
        wprintf(L"%s\n",CkEmailW_lastErrorText(email));
        CkBinDataW_Dispose(pdf);
        CkEmailW_Dispose(email);
        CkBinDataW_Dispose(mime);
        return;
    }

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

    //  Use the same AWS Region for the identity, endpoint, and Signature Version 4.
    region = L"us-west-2";
    host = CkStringBuilderW_Create();
    CkStringBuilderW_Append(host,L"email.");
    CkStringBuilderW_Append(host,region);
    CkStringBuilderW_Append(host,L".amazonaws.com");

    signer = CkAuthAwsW_Create();
    //  Supply the credentials from your application's credential provider.
    CkAuthAwsW_putAccessKey(signer,L"AWS_ACCESS_KEY_ID");
    CkAuthAwsW_putSecretKey(signer,L"AWS_SECRET_ACCESS_KEY");
    CkAuthAwsW_putRegion(signer,region);
    CkAuthAwsW_putServiceName(signer,L"ses");

    connection = CkSocketW_Create();
    CkSocketW_putRequireSslCertVerify(connection,TRUE);
    success = CkSocketW_Connect(connection,CkStringBuilderW_getAsString(host),443,TRUE,10000);
    if (success != TRUE) {
        wprintf(L"%s\n",CkSocketW_lastErrorText(connection));
        CkBinDataW_Dispose(pdf);
        CkEmailW_Dispose(email);
        CkBinDataW_Dispose(mime);
        CkJsonObjectW_Dispose(request);
        CkStringBuilderW_Dispose(host);
        CkAuthAwsW_Dispose(signer);
        CkSocketW_Dispose(connection);
        return;
    }

    rest = CkRestW_Create();
    success = CkRestW_UseConnection(rest,connection,FALSE);
    if (success != TRUE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkBinDataW_Dispose(pdf);
        CkEmailW_Dispose(email);
        CkBinDataW_Dispose(mime);
        CkJsonObjectW_Dispose(request);
        CkStringBuilderW_Dispose(host);
        CkAuthAwsW_Dispose(signer);
        CkSocketW_Dispose(connection);
        CkRestW_Dispose(rest);
        return;
    }

    success = CkRestW_SetAuthAws(rest,signer);
    if (success != TRUE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkBinDataW_Dispose(pdf);
        CkEmailW_Dispose(email);
        CkBinDataW_Dispose(mime);
        CkJsonObjectW_Dispose(request);
        CkStringBuilderW_Dispose(host);
        CkAuthAwsW_Dispose(signer);
        CkSocketW_Dispose(connection);
        CkRestW_Dispose(rest);
        return;
    }

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

    CkRestW_AddHeader(rest,L"Content-Type",L"application/json");
    responseText = CkRestW_fullRequestString(rest,L"POST",L"/v2/email/outbound-emails",CkJsonObjectW_emit(request));
    if (CkRestW_getLastMethodSuccess(rest) != TRUE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkBinDataW_Dispose(pdf);
        CkEmailW_Dispose(email);
        CkBinDataW_Dispose(mime);
        CkJsonObjectW_Dispose(request);
        CkStringBuilderW_Dispose(host);
        CkAuthAwsW_Dispose(signer);
        CkSocketW_Dispose(connection);
        CkRestW_Dispose(rest);
        return;
    }

    if (CkRestW_getResponseStatusCode(rest) != 200) {
        wprintf(L"SES returned HTTP %d %s\n",CkRestW_getResponseStatusCode(rest),responseText);
        CkBinDataW_Dispose(pdf);
        CkEmailW_Dispose(email);
        CkBinDataW_Dispose(mime);
        CkJsonObjectW_Dispose(request);
        CkStringBuilderW_Dispose(host);
        CkAuthAwsW_Dispose(signer);
        CkSocketW_Dispose(connection);
        CkRestW_Dispose(rest);
        return;
    }

    result = CkJsonObjectW_Create();
    success = CkJsonObjectW_Load(result,responseText);
    if (success != TRUE) {
        wprintf(L"%s\n",CkJsonObjectW_lastErrorText(result));
        CkBinDataW_Dispose(pdf);
        CkEmailW_Dispose(email);
        CkBinDataW_Dispose(mime);
        CkJsonObjectW_Dispose(request);
        CkStringBuilderW_Dispose(host);
        CkAuthAwsW_Dispose(signer);
        CkSocketW_Dispose(connection);
        CkRestW_Dispose(rest);
        CkJsonObjectW_Dispose(result);
        return;
    }

    if (CkJsonObjectW_HasMember(result,L"MessageId") != TRUE) {
        wprintf(L"SES returned no message ID.\n");
        CkBinDataW_Dispose(pdf);
        CkEmailW_Dispose(email);
        CkBinDataW_Dispose(mime);
        CkJsonObjectW_Dispose(request);
        CkStringBuilderW_Dispose(host);
        CkAuthAwsW_Dispose(signer);
        CkSocketW_Dispose(connection);
        CkRestW_Dispose(rest);
        CkJsonObjectW_Dispose(result);
        return;
    }

    wprintf(L"SES accepted the message. Message ID: %s\n",CkJsonObjectW_stringOf(result,L"MessageId"));


    CkBinDataW_Dispose(pdf);
    CkEmailW_Dispose(email);
    CkBinDataW_Dispose(mime);
    CkJsonObjectW_Dispose(request);
    CkStringBuilderW_Dispose(host);
    CkAuthAwsW_Dispose(signer);
    CkSocketW_Dispose(connection);
    CkRestW_Dispose(rest);
    CkJsonObjectW_Dispose(result);

    }