Sample code for 30+ languages & platforms
Lianja

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 Lianja Downloads

Download Chilkat for Lianja
Lianja 
llSuccess = .F.

// 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.

loHttp = createobject("CkHttp")

// 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).

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

// Load the embedded image files.
loJpgStarfish = createobject("CkBinData")
loJpgStarfish.LoadFile("qa_data/jpg/starfish.jpg")
loJpgHedgeHogs = createobject("CkBinData")
loJpgHedgeHogs.LoadFile("qa_data/jpg/hedgehogs.jpg")

// Load files that are to be attached (not inline images)
loAttach1 = createobject("CkBinData")
loAttach1.LoadFile("qa_data/pdf/fishing.pdf")
loAttach2 = createobject("CkBinData")
loAttach2.LoadFile("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.
loJson = createobject("CkJsonObject")
loJson.UpdateString("message.subject","Sample HTML Email with Embedded Images and Attachments")
loJson.UpdateString("message.body.contentType","html")
loJson.UpdateString("message.body.content",loSbHtmlBody.GetAsString())

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

loJson.UpdateString('message.attachments[0]."@odata.type"',"#microsoft.graph.fileAttachment")
loJson.UpdateString("message.attachments[0].name","starfish.jpg")
loJson.UpdateString("message.attachments[0].contentType","image/jpeg")
loJson.UpdateInt("message.attachments[0].size",loJpgStarfish.NumBytes)
loJson.UpdateBool("message.attachments[0].isInline",.T.)
// This contentId must match the "cid:" in the HTML
loJson.UpdateString("message.attachments[0].contentId","starfish")
loJson.UpdateNull("message.attachments[0].contentLocation")
loJson.UpdateBd("message.attachments[0].contentBytes","base64",loJpgStarfish)

loJson.UpdateString('message.attachments[1]."@odata.type"',"#microsoft.graph.fileAttachment")
loJson.UpdateString("message.attachments[1].name","hedgehogs.jpg")
loJson.UpdateString("message.attachments[1].contentType","image/jpeg")
loJson.UpdateInt("message.attachments[1].size",loJpgHedgeHogs.NumBytes)
loJson.UpdateBool("message.attachments[1].isInline",.T.)
// This contentId must match the "cid:" in the HTML
loJson.UpdateString("message.attachments[1].contentId","hedgehogs")
loJson.UpdateNull("message.attachments[1].contentLocation")
loJson.UpdateBd("message.attachments[1].contentBytes","base64",loJpgHedgeHogs)

loJson.UpdateString('message.attachments[2]."@odata.type"',"#microsoft.graph.fileAttachment")
loJson.UpdateString("message.attachments[2].name","fishing.pdf")
loJson.UpdateString("message.attachments[2].contentType","application/pdf")
loJson.UpdateInt("message.attachments[2].size",loAttach1.NumBytes)
loJson.UpdateBool("message.attachments[2].isInline",.F.)
loJson.UpdateBd("message.attachments[2].contentBytes","base64",loAttach1)

loJson.UpdateString('message.attachments[3]."@odata.type"',"#microsoft.graph.fileAttachment")
loJson.UpdateString("message.attachments[3].name","sample.docx")
loJson.UpdateString("message.attachments[3].contentType","application/vnd.openxmlformats-officedocument.wordprocessingml.document")
loJson.UpdateInt("message.attachments[3].size",loAttach2.NumBytes)
loJson.UpdateBool("message.attachments[3].isInline",.F.)
loJson.UpdateBd("message.attachments[3].contentBytes","base64",loAttach2)

loJson.UpdateBool("saveToSentItems",.T.)

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

// Send the HTTP POST (i.e. send the HTML email)
loResp = createobject("CkHttpResponse")
llSuccess = loHttp.HttpJson("POST","https://graph.microsoft.com/v1.0/me/sendMail",loJson,"application/json",loResp)
if (llSuccess = .F.) then
    ? loHttp.LastErrorText
    release loHttp
    release loSbHtmlBody
    release loJpgStarfish
    release loJpgHedgeHogs
    release loAttach1
    release loAttach2
    release loJson
    release loResp
    return
endif

// 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 (loResp.StatusCode <> 202) then
    loJson.Load(loResp.BodyStr)
    loJson.EmitCompact = .F.
    ? loJson.Emit()
    ? "Failed, response status code = " + str(loResp.StatusCode)
else
    ? "Outlook HTML Mail Sent."
endif



release loHttp
release loSbHtmlBody
release loJpgStarfish
release loJpgHedgeHogs
release loAttach1
release loAttach2
release loJson
release loResp