(Swift 3,4,5...) Outlook Send HTML Email with Embedded Images

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.

Chilkat Downloads for the Swift Programming Language

MAC OS X (Cocoa) Objective-C/Swift Libs

iOS Objective-C/Swift Libs

func chilkatTest() {
    // 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.

    let http = CkoHttp()!

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

    // Load the image files.
    let jpgStarfish = CkoBinData()!
    jpgStarfish.loadFile("qa_data/jpg/starfish.jpg")
    let jpgHedgeHogs = CkoBinData()!
    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.
    let json = CkoJsonObject()!
    json.update("message.subject", value: "Sample HTML Email with Embedded Images")
    json.update("message.body.contentType", value: "html")
    json.update("message.body.content", value: sbHtmlBody.getAsString())

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

    json.update("message.attachments[0].\"@odata.type\"", value: "#microsoft.graph.fileAttachment")
    json.update("message.attachments[0].name", value: "starfish.jpg")
    json.update("message.attachments[0].contentType", value: "image/jpeg")
    json.updateInt("message.attachments[0].size", value: jpgStarfish.numBytes.intValue)
    json.updateBool("message.attachments[0].isInline", value: true)
    // This contentId must match the "cid:" in the HTML
    json.update("message.attachments[0].contentId", value: "starfish")
    json.updateNull("message.attachments[0].contentLocation")
    json.updateBd("message.attachments[0].contentBytes", encoding: "base64", bd: jpgStarfish)

    json.update("message.attachments[1].\"@odata.type\"", value: "#microsoft.graph.fileAttachment")
    json.update("message.attachments[1].name", value: "hedgehogs.jpg")
    json.update("message.attachments[1].contentType", value: "image/jpeg")
    json.updateInt("message.attachments[1].size", value: jpgHedgeHogs.numBytes.intValue)
    json.updateBool("message.attachments[1].isInline", value: true)
    // This contentId must match the "cid:" in the HTML
    json.update("message.attachments[1].contentId", value: "hedgehogs")
    json.updateNull("message.attachments[1].contentLocation")
    json.updateBd("message.attachments[1].contentBytes", encoding: "base64", bd: jpgHedgeHogs)

    json.updateBool("saveToSentItems", value: true)

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

    // Send the HTTP POST (i.e. send the HTML email)
    var resp: CkoHttpResponse? = http.postJson3("https://graph.microsoft.com/v1.0/me/sendMail", contentType: "application/json", json: json)
    if http.lastMethodSuccess != true {
        print("\(http.lastErrorText!)")
        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 resp!.statusCode.intValue != 202 {
        json.load(resp!.bodyStr)
        json.emitCompact = false
        print("\(json.emit()!)")
        print("Failed, response status code = \(resp!.statusCode.intValue)")
    }
    else {
        print("Outlook HTML Mail Sent.")
    }

    resp = nil

}