Sample code for 30+ languages & platforms
SQL Server

Outlook Send HTML Email

See more Outlook Examples

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

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

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

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

    -- 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",
    -- 	    "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"
    -- 	        }
    -- 	      }
    -- 	    ]
    -- 	  },
    -- 	  "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'
    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, 'UpdateBool', @success OUT, 'saveToSentItems', 1

    -- 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 @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 @json
    EXEC @hr = sp_OADestroy @resp


END
GO