Sample code for 30+ languages & platforms
SQL Server

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 SQL Server Downloads

SQL Server
-- Important: See this note about string length limitations for strings returned by sp_OAMethod calls.
--
CREATE PROCEDURE ChilkatSample
AS
BEGIN
    DECLARE @hr int
    DECLARE @iTmp0 int
    -- Important: Do not use nvarchar(max).  See the warning about using nvarchar(max).
    DECLARE @sTmp0 nvarchar(4000)
    DECLARE @success int
    SELECT @success = 0

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

    DECLARE @http int
    EXEC @hr = sp_OACreate 'Chilkat.Http', @http OUT
    IF @hr <> 0
    BEGIN
        PRINT 'Failed to create ActiveX component'
        RETURN
    END

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

    EXEC sp_OASetProperty @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...
    DECLARE @bCrlf int
    SELECT @bCrlf = 1
    DECLARE @sbHtmlBody int
    EXEC @hr = sp_OACreate 'Chilkat.StringBuilder', @sbHtmlBody OUT

    EXEC sp_OAMethod @sbHtmlBody, 'AppendLine', @success OUT, '<html>', @bCrlf
    EXEC sp_OAMethod @sbHtmlBody, 'AppendLine', @success OUT, '<head>', @bCrlf
    EXEC sp_OAMethod @sbHtmlBody, 'AppendLine', @success OUT, '<meta http-equiv="Content-Type" content="text/html; charset=utf-8">', @bCrlf
    EXEC sp_OAMethod @sbHtmlBody, 'AppendLine', @success OUT, '<meta content="text/html; charset=utf-8">', @bCrlf
    EXEC sp_OAMethod @sbHtmlBody, 'AppendLine', @success OUT, '</head>', @bCrlf
    EXEC sp_OAMethod @sbHtmlBody, 'AppendLine', @success OUT, '<body bgcolor="#FFFFFF">', @bCrlf
    EXEC sp_OAMethod @sbHtmlBody, 'AppendLine', @success OUT, '<font face="Calibri">This is a test <b>HTML email with embedded images</b>.<br>', @bCrlf
    EXEC sp_OAMethod @sbHtmlBody, 'AppendLine', @success OUT, '<br>', @bCrlf
    EXEC sp_OAMethod @sbHtmlBody, 'AppendLine', @success OUT, '<img alt="" src="cid:starfish"><br>', @bCrlf
    EXEC sp_OAMethod @sbHtmlBody, 'AppendLine', @success OUT, '<img alt="" src="cid:hedgehogs"><br>', @bCrlf
    EXEC sp_OAMethod @sbHtmlBody, 'AppendLine', @success OUT, '</font>', @bCrlf
    EXEC sp_OAMethod @sbHtmlBody, 'AppendLine', @success OUT, '</body>', @bCrlf
    EXEC sp_OAMethod @sbHtmlBody, 'AppendLine', @success OUT, '</html>', @bCrlf

    -- Load the image files.
    DECLARE @jpgStarfish int
    EXEC @hr = sp_OACreate 'Chilkat.BinData', @jpgStarfish OUT

    EXEC sp_OAMethod @jpgStarfish, 'LoadFile', @success OUT, 'qa_data/jpg/starfish.jpg'
    DECLARE @jpgHedgeHogs int
    EXEC @hr = sp_OACreate 'Chilkat.BinData', @jpgHedgeHogs OUT

    EXEC sp_OAMethod @jpgHedgeHogs, 'LoadFile', @success OUT, '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.
    DECLARE @json int
    EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @json OUT

    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'message.subject', 'Sample HTML Email with Embedded Images'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'message.body.contentType', 'html'
    EXEC sp_OAMethod @sbHtmlBody, 'GetAsString', @sTmp0 OUT
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'message.body.content', @sTmp0

    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'message.toRecipients[0].emailAddress.name', 'Chilkat Software'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'message.toRecipients[0].emailAddress.address', 'admin@chilkat.io'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'message.toRecipients[1].emailAddress.address', 'chilkat.support@gmail.com'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'message.ccRecipients[0].emailAddress.name', 'Chilkat Blog'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'message.ccRecipients[0].emailAddress.address', 'admin@cknotes.com'

    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'message.attachments[0]."@odata.type"', '#microsoft.graph.fileAttachment'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'message.attachments[0].name', 'starfish.jpg'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'message.attachments[0].contentType', 'image/jpeg'
    EXEC sp_OAGetProperty @jpgStarfish, 'NumBytes', @iTmp0 OUT
    EXEC sp_OAMethod @json, 'UpdateInt', @success OUT, 'message.attachments[0].size', @iTmp0
    EXEC sp_OAMethod @json, 'UpdateBool', @success OUT, 'message.attachments[0].isInline', 1
    -- This contentId must match the "cid:" in the HTML
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'message.attachments[0].contentId', 'starfish'
    EXEC sp_OAMethod @json, 'UpdateNull', @success OUT, 'message.attachments[0].contentLocation'
    EXEC sp_OAMethod @json, 'UpdateBd', @success OUT, 'message.attachments[0].contentBytes', 'base64', @jpgStarfish

    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'message.attachments[1]."@odata.type"', '#microsoft.graph.fileAttachment'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'message.attachments[1].name', 'hedgehogs.jpg'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'message.attachments[1].contentType', 'image/jpeg'
    EXEC sp_OAGetProperty @jpgHedgeHogs, 'NumBytes', @iTmp0 OUT
    EXEC sp_OAMethod @json, 'UpdateInt', @success OUT, 'message.attachments[1].size', @iTmp0
    EXEC sp_OAMethod @json, 'UpdateBool', @success OUT, 'message.attachments[1].isInline', 1
    -- This contentId must match the "cid:" in the HTML
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'message.attachments[1].contentId', 'hedgehogs'
    EXEC sp_OAMethod @json, 'UpdateNull', @success OUT, 'message.attachments[1].contentLocation'
    EXEC sp_OAMethod @json, 'UpdateBd', @success OUT, 'message.attachments[1].contentBytes', 'base64', @jpgHedgeHogs

    EXEC sp_OAMethod @json, 'UpdateBool', @success OUT, 'saveToSentItems', 1

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

    -- Send the HTTP POST (i.e. send the HTML email)
    DECLARE @resp int
    EXEC @hr = sp_OACreate 'Chilkat.HttpResponse', @resp OUT

    EXEC sp_OAMethod @http, 'HttpJson', @success OUT, 'POST', 'https://graph.microsoft.com/v1.0/me/sendMail', @json, 'application/json', @resp
    IF @success = 0
      BEGIN
        EXEC sp_OAGetProperty @http, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @sbHtmlBody
        EXEC @hr = sp_OADestroy @jpgStarfish
        EXEC @hr = sp_OADestroy @jpgHedgeHogs
        EXEC @hr = sp_OADestroy @json
        EXEC @hr = sp_OADestroy @resp
        RETURN
      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.)
    EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
    IF @iTmp0 <> 202
      BEGIN
        EXEC sp_OAGetProperty @resp, 'BodyStr', @sTmp0 OUT
        EXEC sp_OAMethod @json, 'Load', @success OUT, @sTmp0
        EXEC sp_OASetProperty @json, 'EmitCompact', 0
        EXEC sp_OAMethod @json, 'Emit', @sTmp0 OUT
        PRINT @sTmp0

        EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
        PRINT 'Failed, response status code = ' + @iTmp0
      END
    ELSE
      BEGIN

        PRINT 'Outlook HTML Mail Sent.'
      END

    EXEC @hr = sp_OADestroy @http
    EXEC @hr = sp_OADestroy @sbHtmlBody
    EXEC @hr = sp_OADestroy @jpgStarfish
    EXEC @hr = sp_OADestroy @jpgHedgeHogs
    EXEC @hr = sp_OADestroy @json
    EXEC @hr = sp_OADestroy @resp


END
GO