Sample code for 30+ languages & platforms
B4X

Outlook Send HTML Email with Embedded Images

See more Outlook Examples

This example sends an HTML email with embedded images. Other examples exist for:
  • Sending plain-text email.
  • Sending email with attachments.
  • Sending HTML email with embedded images and attachments.

This example applies to: Exchange Online | Office 365 | Hotmail.com | Live.com | MSN.com | Outlook.com | Passport.com

Chilkat B4X Downloads

B4X
Dim success As Boolean = 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.

Dim http As ChilkatHttp
http.Initialize("http")

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

http.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...
Dim bCrlf As Boolean = True
Dim sbHtmlBody As ChilkatStringBuilder
sbHtmlBody.Initialize
sbHtmlBody.AppendLine("<html>", bCrlf)
sbHtmlBody.AppendLine("<head>", bCrlf)
sbHtmlBody.AppendLine("<meta http-equiv=" & Chr(34) & "Content-Type" & Chr(34) & " content=" & Chr(34) & "text/html; charset=utf-8" & Chr(34) & ">", bCrlf)
sbHtmlBody.AppendLine("<meta content=" & Chr(34) & "text/html; charset=utf-8" & Chr(34) & ">", bCrlf)
sbHtmlBody.AppendLine("</head>", bCrlf)
sbHtmlBody.AppendLine("<body bgcolor=" & Chr(34) & "#FFFFFF" & Chr(34) & ">", bCrlf)
sbHtmlBody.AppendLine("<font face=" & Chr(34) & "Calibri" & Chr(34) & ">This is a test <b>HTML email with embedded images</b>.<br>", bCrlf)
sbHtmlBody.AppendLine("<br>", bCrlf)
sbHtmlBody.AppendLine("<img alt=" & Chr(34) & Chr(34) & " src=" & Chr(34) & "cid:starfish" & Chr(34) & "><br>", bCrlf)
sbHtmlBody.AppendLine("<img alt=" & Chr(34) & Chr(34) & " src=" & Chr(34) & "cid:hedgehogs" & Chr(34) & "><br>", bCrlf)
sbHtmlBody.AppendLine("</font>", bCrlf)
sbHtmlBody.AppendLine("</body>", bCrlf)
sbHtmlBody.AppendLine("</html>", bCrlf)

'  Load the image files.
Dim jpgStarfish As ChilkatBinData
jpgStarfish.Initialize
jpgStarfish.LoadFile("qa_data/jpg/starfish.jpg")
Dim jpgHedgeHogs As ChilkatBinData
jpgHedgeHogs.Initialize
jpgHedgeHogs.LoadFile("qa_data/jpg/hedgehogs.jpg")

'  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:
'  

'  	{
'  	  "message": {
'  	    "subject": "Sample HTML Email with Embedded Images",
'  	    "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"
'  	       }
'  	    ]
'  	  },
'  	  "saveToSentItems": true
'  	}
'  
'  Build the above JSON.
Dim json As ChilkatJsonObject
json.Initialize
json.UpdateString("message.subject", "Sample HTML Email with Embedded Images")
json.UpdateString("message.body.contentType", "html")
json.UpdateString("message.body.content", sbHtmlBody.GetAsString)

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

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

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

json.UpdateBool("saveToSentItems", True)

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

'  Send the HTTP POST (i.e. send the HTML email)
Dim resp As ChilkatHttpResponse
resp.Initialize
success = http.HttpJson("POST", "https://graph.microsoft.com/v1.0/me/sendMail", json, "application/json", resp)
If success = False Then
    Log(http.LastErrorText)
    Return
End If


'  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 resp.StatusCode <> 202 Then
    json.Load(resp.BodyStr)
    json.EmitCompact = False
    Log(json.Emit)
    Log("Failed, response status code = " & resp.StatusCode)
Else
    Log("Outlook HTML Mail Sent.")
End If