Unicode C
Unicode C
Outlook Send HTML Email with Embedded Images and Attachments
See more Outlook Examples
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.
This example applies to: Exchange Online | Office 365 | Hotmail.com | Live.com | MSN.com | Outlook.com | Passport.com
Chilkat Unicode C Downloads
#include <C_CkHttpW.h>
#include <C_CkStringBuilderW.h>
#include <C_CkBinDataW.h>
#include <C_CkJsonObjectW.h>
#include <C_CkHttpResponseW.h>
void ChilkatSample(void)
{
BOOL success;
HCkHttpW http;
BOOL bCrlf;
HCkStringBuilderW sbHtmlBody;
HCkBinDataW jpgStarfish;
HCkBinDataW jpgHedgeHogs;
HCkBinDataW attach1;
HCkBinDataW attach2;
HCkJsonObjectW json;
HCkHttpResponseW resp;
success = FALSE;
// 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 = CkHttpResponseW_Create();
success = CkHttpW_HttpJson(http,L"POST",L"https://graph.microsoft.com/v1.0/me/sendMail",json,L"application/json",resp);
if (success == FALSE) {
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);
CkHttpResponseW_Dispose(resp);
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");
}
CkHttpW_Dispose(http);
CkStringBuilderW_Dispose(sbHtmlBody);
CkBinDataW_Dispose(jpgStarfish);
CkBinDataW_Dispose(jpgHedgeHogs);
CkBinDataW_Dispose(attach1);
CkBinDataW_Dispose(attach2);
CkJsonObjectW_Dispose(json);
CkHttpResponseW_Dispose(resp);
}