Sample code for 30+ languages & platforms
Delphi DLL Requires Chilkat v9.5.0.68+

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 Delphi DLL Downloads

Delphi DLL
var
success: Boolean;
http: HCkHttp;
bCrlf: Boolean;
sbHtmlBody: HCkStringBuilder;
jpgStarfish: HCkBinData;
jpgHedgeHogs: HCkBinData;
attach1: HCkBinData;
attach2: HCkBinData;
json: HCkJsonObject;
resp: HCkHttpResponse;

begin
success := False;

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

http := CkHttp_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).

CkHttp_putAuthToken(http,'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 := CkStringBuilder_Create();
CkStringBuilder_AppendLine(sbHtmlBody,'<html>',bCrlf);
CkStringBuilder_AppendLine(sbHtmlBody,'<head>',bCrlf);
CkStringBuilder_AppendLine(sbHtmlBody,'<meta http-equiv="Content-Type" content="text/html; charset=utf-8">',bCrlf);
CkStringBuilder_AppendLine(sbHtmlBody,'<meta content="text/html; charset=utf-8">',bCrlf);
CkStringBuilder_AppendLine(sbHtmlBody,'</head>',bCrlf);
CkStringBuilder_AppendLine(sbHtmlBody,'<body bgcolor="#FFFFFF">',bCrlf);
CkStringBuilder_AppendLine(sbHtmlBody,'<font face="Calibri">This is a test <b>HTML email with embedded images</b>.<br>',bCrlf);
CkStringBuilder_AppendLine(sbHtmlBody,'<br>',bCrlf);
CkStringBuilder_AppendLine(sbHtmlBody,'<img alt="" src="cid:starfish"><br>',bCrlf);
CkStringBuilder_AppendLine(sbHtmlBody,'<img alt="" src="cid:hedgehogs"><br>',bCrlf);
CkStringBuilder_AppendLine(sbHtmlBody,'</font>',bCrlf);
CkStringBuilder_AppendLine(sbHtmlBody,'</body>',bCrlf);
CkStringBuilder_AppendLine(sbHtmlBody,'</html>',bCrlf);

//  Load the embedded image files.
jpgStarfish := CkBinData_Create();
CkBinData_LoadFile(jpgStarfish,'qa_data/jpg/starfish.jpg');
jpgHedgeHogs := CkBinData_Create();
CkBinData_LoadFile(jpgHedgeHogs,'qa_data/jpg/hedgehogs.jpg');

//  Load files that are to be attached (not inline images)
attach1 := CkBinData_Create();
CkBinData_LoadFile(attach1,'qa_data/pdf/fishing.pdf');
attach2 := CkBinData_Create();
CkBinData_LoadFile(attach2,'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 := CkJsonObject_Create();
CkJsonObject_UpdateString(json,'message.subject','Sample HTML Email with Embedded Images and Attachments');
CkJsonObject_UpdateString(json,'message.body.contentType','html');
CkJsonObject_UpdateString(json,'message.body.content',CkStringBuilder__getAsString(sbHtmlBody));

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

CkJsonObject_UpdateString(json,'message.attachments[0]."@odata.type"','#microsoft.graph.fileAttachment');
CkJsonObject_UpdateString(json,'message.attachments[0].name','starfish.jpg');
CkJsonObject_UpdateString(json,'message.attachments[0].contentType','image/jpeg');
CkJsonObject_UpdateInt(json,'message.attachments[0].size',CkBinData_getNumBytes(jpgStarfish));
CkJsonObject_UpdateBool(json,'message.attachments[0].isInline',True);
//  This contentId must match the "cid:" in the HTML
CkJsonObject_UpdateString(json,'message.attachments[0].contentId','starfish');
CkJsonObject_UpdateNull(json,'message.attachments[0].contentLocation');
CkJsonObject_UpdateBd(json,'message.attachments[0].contentBytes','base64',jpgStarfish);

CkJsonObject_UpdateString(json,'message.attachments[1]."@odata.type"','#microsoft.graph.fileAttachment');
CkJsonObject_UpdateString(json,'message.attachments[1].name','hedgehogs.jpg');
CkJsonObject_UpdateString(json,'message.attachments[1].contentType','image/jpeg');
CkJsonObject_UpdateInt(json,'message.attachments[1].size',CkBinData_getNumBytes(jpgHedgeHogs));
CkJsonObject_UpdateBool(json,'message.attachments[1].isInline',True);
//  This contentId must match the "cid:" in the HTML
CkJsonObject_UpdateString(json,'message.attachments[1].contentId','hedgehogs');
CkJsonObject_UpdateNull(json,'message.attachments[1].contentLocation');
CkJsonObject_UpdateBd(json,'message.attachments[1].contentBytes','base64',jpgHedgeHogs);

CkJsonObject_UpdateString(json,'message.attachments[2]."@odata.type"','#microsoft.graph.fileAttachment');
CkJsonObject_UpdateString(json,'message.attachments[2].name','fishing.pdf');
CkJsonObject_UpdateString(json,'message.attachments[2].contentType','application/pdf');
CkJsonObject_UpdateInt(json,'message.attachments[2].size',CkBinData_getNumBytes(attach1));
CkJsonObject_UpdateBool(json,'message.attachments[2].isInline',False);
CkJsonObject_UpdateBd(json,'message.attachments[2].contentBytes','base64',attach1);

CkJsonObject_UpdateString(json,'message.attachments[3]."@odata.type"','#microsoft.graph.fileAttachment');
CkJsonObject_UpdateString(json,'message.attachments[3].name','sample.docx');
CkJsonObject_UpdateString(json,'message.attachments[3].contentType','application/vnd.openxmlformats-officedocument.wordprocessingml.document');
CkJsonObject_UpdateInt(json,'message.attachments[3].size',CkBinData_getNumBytes(attach2));
CkJsonObject_UpdateBool(json,'message.attachments[3].isInline',False);
CkJsonObject_UpdateBd(json,'message.attachments[3].contentBytes','base64',attach2);

CkJsonObject_UpdateBool(json,'saveToSentItems',True);

//  Send the HTTP POST (i.e. send the HTML email)
resp := CkHttpResponse_Create();
success := CkHttp_HttpJson(http,'POST','https://graph.microsoft.com/v1.0/me/sendMail',json,'application/json',resp);
if (success = False) then
  begin
    Memo1.Lines.Add(CkHttp__lastErrorText(http));
    Exit;
  end;

//  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 (CkHttpResponse_getStatusCode(resp) <> 202) then
  begin
    CkJsonObject_Load(json,CkHttpResponse__bodyStr(resp));
    CkJsonObject_putEmitCompact(json,False);
    Memo1.Lines.Add(CkJsonObject__emit(json));
    Memo1.Lines.Add('Failed, response status code = ' + IntToStr(CkHttpResponse_getStatusCode(resp)));
  end
else
  begin
    Memo1.Lines.Add('Outlook HTML Mail Sent.');
  end;

CkHttp_Dispose(http);
CkStringBuilder_Dispose(sbHtmlBody);
CkBinData_Dispose(jpgStarfish);
CkBinData_Dispose(jpgHedgeHogs);
CkBinData_Dispose(attach1);
CkBinData_Dispose(attach2);
CkJsonObject_Dispose(json);
CkHttpResponse_Dispose(resp);