(Unicode C) Outlook Send HTML Email with Embedded Images and Attachments

This example sends an HTML email with both embedded images and attachments. Other examples exist for:

Sending plain-text email.
Sending HTML email.
Sending HTML email with embedded images.
Sending plain-text email with attachments.

Chilkat C/C++ Library Downloads

MS Visual C/C++

Linux/CentOS C/C++

Alpine Linux C/C++

MAC OS X C/C++

armhf/aarch64 C/C++

C++ Builder

iOS C/C++

Android C/C++

Solaris C/C++

MinGW C/C++

#include <C_CkHttpW.h>
#include <C_CkStringBuilderW.h>
#include <C_CkBinDataW.h>
#include <C_CkJsonObjectW.h>
#include <C_CkHttpResponseW.h>

void ChilkatSample(void)
    {
    HCkHttpW http;
    BOOL bCrlf;
    HCkStringBuilderW sbHtmlBody;
    HCkBinDataW jpgStarfish;
    HCkBinDataW jpgHedgeHogs;
    HCkBinDataW attach1;
    HCkBinDataW attach2;
    HCkJsonObjectW json;
    HCkHttpResponseW resp;

    // Important: This example requires Chilkat v9.5.0.68 or greater.

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    http = CkHttpW_Create();

    // Use your previously obtained access token here:
    // See the following examples for getting an access token:
    //    Get Microsoft Graph OAuth2 Access Token (Azure AD v2.0 Endpoint).
    //    Get Microsoft Graph OAuth2 Access Token (Azure AD Endpoint).
    //    Refresh Access Token (Azure AD v2.0 Endpoint).
    //    Refresh Access Token (Azure AD Endpoint).

    CkHttpW_putAuthToken(http,L"MICROSOFT_GRAPH_ACCESS_TOKEN");

    // To send mail, we'll POST to the following endpoint:
    // 
    // POST /users/{id | userPrincipalName}/sendMail
    // 
    // (The special keyword "me" may be used in place of a principal name.)
    // 

    // This example will send HTML email containing the following HTML body.
    // After the 

    // 	<html>
    // 	<head>
    // 	<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    // 	<meta content="text/html; charset=utf-8">
    // 	</head>
    // 	<body bgcolor="#FFFFFF">
    // 	<font face="Calibri">This is a test <b>HTML email with embedded images</b>.<br>
    // 	<br>
    // 	<img alt="" src="cid:starfish"><br>
    // 	<img alt="" src="cid:hedgehogs"><br>
    // 	</font>
    // 	</body>
    // 	</html>

    // Build the HTML body...
    bCrlf = TRUE;
    sbHtmlBody = CkStringBuilderW_Create();
    CkStringBuilderW_AppendLine(sbHtmlBody,L"<html>",bCrlf);
    CkStringBuilderW_AppendLine(sbHtmlBody,L"<head>",bCrlf);
    CkStringBuilderW_AppendLine(sbHtmlBody,L"<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">",bCrlf);
    CkStringBuilderW_AppendLine(sbHtmlBody,L"<meta content=\"text/html; charset=utf-8\">",bCrlf);
    CkStringBuilderW_AppendLine(sbHtmlBody,L"</head>",bCrlf);
    CkStringBuilderW_AppendLine(sbHtmlBody,L"<body bgcolor=\"#FFFFFF\">",bCrlf);
    CkStringBuilderW_AppendLine(sbHtmlBody,L"<font face=\"Calibri\">This is a test <b>HTML email with embedded images</b>.<br>",bCrlf);
    CkStringBuilderW_AppendLine(sbHtmlBody,L"<br>",bCrlf);
    CkStringBuilderW_AppendLine(sbHtmlBody,L"<img alt=\"\" src=\"cid:starfish\"><br>",bCrlf);
    CkStringBuilderW_AppendLine(sbHtmlBody,L"<img alt=\"\" src=\"cid:hedgehogs\"><br>",bCrlf);
    CkStringBuilderW_AppendLine(sbHtmlBody,L"</font>",bCrlf);
    CkStringBuilderW_AppendLine(sbHtmlBody,L"</body>",bCrlf);
    CkStringBuilderW_AppendLine(sbHtmlBody,L"</html>",bCrlf);

    // Load the embedded image files.
    jpgStarfish = CkBinDataW_Create();
    CkBinDataW_LoadFile(jpgStarfish,L"qa_data/jpg/starfish.jpg");
    jpgHedgeHogs = CkBinDataW_Create();
    CkBinDataW_LoadFile(jpgHedgeHogs,L"qa_data/jpg/hedgehogs.jpg");

    // Load files that are to be attached (not inline images)
    attach1 = CkBinDataW_Create();
    CkBinDataW_LoadFile(attach1,L"qa_data/pdf/fishing.pdf");
    attach2 = CkBinDataW_Create();
    CkBinDataW_LoadFile(attach2,L"qa_data/msword/sample.docx");

    // The body of the POST request contains JSON that specifies the email subject, body,
    // recipients, etc.  This example will build the following JSON HTML email with
    // two embedded images and two attachments.
    // 
    // The only difference between an embedded inline image and an attachment is that the
    // inline image must have a cid that corresponds to the "cid:" found in the "src" attribute
    // of an IMG tag within the HTML body of the email.  (The inline image is also marked as "isInline",
    // whereas the attachments are not, but I don't know if this actually makes a difference..)
    // 

    // 	{
    // 	  "message": {
    // 	    "subject": "Sample HTML Email with Embedded Images and Attachments",
    // 	    "body": {
    // 	      "contentType": "html",
    // 	      "content": "The HTML body goes here..."
    // 	    },
    // 	    "toRecipients": [
    // 	      {
    // 	        "emailAddress": {
    // 		  "name": "Chilkat Software",
    // 	          "address": "admin@chilkat.io"
    // 	        }
    // 	      },
    // 	      {
    // 	        "emailAddress": {
    // 	          "address": "chilkat.support@gmail.com"
    // 	        }
    // 	      }
    // 	    ],
    // 	    "ccRecipients": [
    // 	      {
    // 	        "emailAddress": {
    // 		  "name": "Chilkat Blog",
    // 		  "address": "admin@cknotes.com"
    // 	        }
    // 	      }
    // 	    ],
    // 	    "attachments": [
    // 	       {
    // 	         "@odata.type": "#microsoft.graph.fileAttachment",
    // 	         "name": "starfish.jpg",
    // 	         "contentType": "image/jpeg",
    // 	         "size": 6497,
    // 	         "isInline": true,
    // 	         "contentId": "starfish",
    // 	         "contentLocation": null,
    // 	         "contentBytes": "base64_data_here"
    // 	       },
    // 	       {
    // 	         "@odata.type": "#microsoft.graph.fileAttachment",
    // 	         "name": "hedgehogs.jpg",
    // 	         "contentType": "image/jpeg",
    // 	         "size": 48845,
    // 	         "isInline": true,
    // 	         "contentId": "hedgehogs",
    // 	         "contentLocation": null,
    // 	         "contentBytes": "base64_data_here"
    // 	       },
    // 	       {
    // 	         "@odata.type": "#microsoft.graph.fileAttachment",
    // 	         "name": "fishing.pdf",
    // 	         "contentType": "application/pdf",
    // 	         "size": <theActualSize>,
    // 	         "isInline": false,
    // 	         "contentBytes": "base64_data_here"
    // 	       },
    // 	       {
    // 	         "@odata.type": "#microsoft.graph.fileAttachment",
    // 	         "name": "sample.docx",
    // 	         "contentType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
    // 	         "size": <theActualSize>,
    // 	         "isInline": false,
    // 	         "contentBytes": "base64_data_here"
    // 	       }
    // 	    ]
    // 	  },
    // 	  "saveToSentItems": true
    // 	}
    // 
    // Build the above JSON.
    json = CkJsonObjectW_Create();
    CkJsonObjectW_UpdateString(json,L"message.subject",L"Sample HTML Email with Embedded Images and Attachments");
    CkJsonObjectW_UpdateString(json,L"message.body.contentType",L"html");
    CkJsonObjectW_UpdateString(json,L"message.body.content",CkStringBuilderW_getAsString(sbHtmlBody));

    CkJsonObjectW_UpdateString(json,L"message.toRecipients[0].emailAddress.name",L"Chilkat Software");
    CkJsonObjectW_UpdateString(json,L"message.toRecipients[0].emailAddress.address",L"admin@chilkat.io");
    CkJsonObjectW_UpdateString(json,L"message.toRecipients[1].emailAddress.address",L"chilkat.support@gmail.com");
    CkJsonObjectW_UpdateString(json,L"message.ccRecipients[0].emailAddress.name",L"Chilkat Blog");
    CkJsonObjectW_UpdateString(json,L"message.ccRecipients[0].emailAddress.address",L"admin@cknotes.com");

    CkJsonObjectW_UpdateString(json,L"message.attachments[0].\"@odata.type\"",L"#microsoft.graph.fileAttachment");
    CkJsonObjectW_UpdateString(json,L"message.attachments[0].name",L"starfish.jpg");
    CkJsonObjectW_UpdateString(json,L"message.attachments[0].contentType",L"image/jpeg");
    CkJsonObjectW_UpdateInt(json,L"message.attachments[0].size",CkBinDataW_getNumBytes(jpgStarfish));
    CkJsonObjectW_UpdateBool(json,L"message.attachments[0].isInline",TRUE);
    // This contentId must match the "cid:" in the HTML
    CkJsonObjectW_UpdateString(json,L"message.attachments[0].contentId",L"starfish");
    CkJsonObjectW_UpdateNull(json,L"message.attachments[0].contentLocation");
    CkJsonObjectW_UpdateBd(json,L"message.attachments[0].contentBytes",L"base64",jpgStarfish);

    CkJsonObjectW_UpdateString(json,L"message.attachments[1].\"@odata.type\"",L"#microsoft.graph.fileAttachment");
    CkJsonObjectW_UpdateString(json,L"message.attachments[1].name",L"hedgehogs.jpg");
    CkJsonObjectW_UpdateString(json,L"message.attachments[1].contentType",L"image/jpeg");
    CkJsonObjectW_UpdateInt(json,L"message.attachments[1].size",CkBinDataW_getNumBytes(jpgHedgeHogs));
    CkJsonObjectW_UpdateBool(json,L"message.attachments[1].isInline",TRUE);
    // This contentId must match the "cid:" in the HTML
    CkJsonObjectW_UpdateString(json,L"message.attachments[1].contentId",L"hedgehogs");
    CkJsonObjectW_UpdateNull(json,L"message.attachments[1].contentLocation");
    CkJsonObjectW_UpdateBd(json,L"message.attachments[1].contentBytes",L"base64",jpgHedgeHogs);

    CkJsonObjectW_UpdateString(json,L"message.attachments[2].\"@odata.type\"",L"#microsoft.graph.fileAttachment");
    CkJsonObjectW_UpdateString(json,L"message.attachments[2].name",L"fishing.pdf");
    CkJsonObjectW_UpdateString(json,L"message.attachments[2].contentType",L"application/pdf");
    CkJsonObjectW_UpdateInt(json,L"message.attachments[2].size",CkBinDataW_getNumBytes(attach1));
    CkJsonObjectW_UpdateBool(json,L"message.attachments[2].isInline",FALSE);
    CkJsonObjectW_UpdateBd(json,L"message.attachments[2].contentBytes",L"base64",attach1);

    CkJsonObjectW_UpdateString(json,L"message.attachments[3].\"@odata.type\"",L"#microsoft.graph.fileAttachment");
    CkJsonObjectW_UpdateString(json,L"message.attachments[3].name",L"sample.docx");
    CkJsonObjectW_UpdateString(json,L"message.attachments[3].contentType",L"application/vnd.openxmlformats-officedocument.wordprocessingml.document");
    CkJsonObjectW_UpdateInt(json,L"message.attachments[3].size",CkBinDataW_getNumBytes(attach2));
    CkJsonObjectW_UpdateBool(json,L"message.attachments[3].isInline",FALSE);
    CkJsonObjectW_UpdateBd(json,L"message.attachments[3].contentBytes",L"base64",attach2);

    CkJsonObjectW_UpdateBool(json,L"saveToSentItems",TRUE);

    // -------------------------------------------------------------
    // Important: This example requires Chilkat v9.5.0.68 or greater.
    // -------------------------------------------------------------

    // Send the HTTP POST (i.e. send the HTML email)
    resp = CkHttpW_PostJson3(http,L"https://graph.microsoft.com/v1.0/me/sendMail",L"application/json",json);
    if (CkHttpW_getLastMethodSuccess(http) != TRUE) {
        wprintf(L"%s\n",CkHttpW_lastErrorText(http));
        CkHttpW_Dispose(http);
        CkStringBuilderW_Dispose(sbHtmlBody);
        CkBinDataW_Dispose(jpgStarfish);
        CkBinDataW_Dispose(jpgHedgeHogs);
        CkBinDataW_Dispose(attach1);
        CkBinDataW_Dispose(attach2);
        CkJsonObjectW_Dispose(json);
        return;
    }

    // The send succeeded if the response status code = 202.
    // In the success case, there is no response body.  (We just get the response code to know that it succeeded.)
    if (CkHttpResponseW_getStatusCode(resp) != 202) {
        CkJsonObjectW_Load(json,CkHttpResponseW_bodyStr(resp));
        CkJsonObjectW_putEmitCompact(json,FALSE);
        wprintf(L"%s\n",CkJsonObjectW_emit(json));
        wprintf(L"Failed, response status code = %d\n",CkHttpResponseW_getStatusCode(resp));
    }
    else {
        wprintf(L"Outlook HTML Mail Sent.\n");
    }

    CkHttpResponseW_Dispose(resp);


    CkHttpW_Dispose(http);
    CkStringBuilderW_Dispose(sbHtmlBody);
    CkBinDataW_Dispose(jpgStarfish);
    CkBinDataW_Dispose(jpgHedgeHogs);
    CkBinDataW_Dispose(attach1);
    CkBinDataW_Dispose(attach2);
    CkJsonObjectW_Dispose(json);

    }