Sample code for 30+ languages & platforms
Pascal (Lazarus/Delphi)

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 Pascal (Lazarus/Delphi) Downloads

Pascal (Lazarus/Delphi)
program ChilkatDemo;

// Demonstrates using the Chilkat Pascal wrapper via the C bridge DLL.
// Builds as a console application under Lazarus (FPC) or Delphi.

{$IFDEF FPC}
  {$MODE DELPHI}
{$ENDIF}
{$APPTYPE CONSOLE}

uses
  {$IFDEF UNIX}
  cthreads,
  {$ENDIF}
  SysUtils,
  CkDllLoader,
  Chilkat.Http,
  Chilkat.StringBuilder,
  Chilkat.HttpResponse,
  Chilkat.BinData,
  Chilkat.JsonObject;

// ---------------------------------------------------------------------------

procedure RunDemo;
var
  success: Boolean;
  http: THttp;
  bCrlf: Boolean;
  sbHtmlBody: TStringBuilder;
  jpgStarfish: TBinData;
  jpgHedgeHogs: TBinData;
  json: TJsonObject;
  resp: THttpResponse;

begin
  success := 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.

  http := THttp.Create;

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

  //  Load the image files.
  jpgStarfish := TBinData.Create;
  jpgStarfish.LoadFile('qa_data/jpg/starfish.jpg');
  jpgHedgeHogs := TBinData.Create;
  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.
  json := TJsonObject.Create;
  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]."@odata.type"','#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]."@odata.type"','#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)
  resp := THttpResponse.Create;
  success := http.HttpJson('POST','https://graph.microsoft.com/v1.0/me/sendMail',json,'application/json',resp);
  if (success = False) then
    begin
      WriteLn(http.LastErrorText);
      Exit;
    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.)
  if (resp.StatusCode <> 202) then
    begin
      json.Load(resp.BodyStr);
      json.EmitCompact := False;
      WriteLn(json.Emit());
      WriteLn('Failed, response status code = ' + resp.StatusCode);
    end
  else
    begin
      WriteLn('Outlook HTML Mail Sent.');
    end;


  http.Free;
  sbHtmlBody.Free;
  jpgStarfish.Free;
  jpgHedgeHogs.Free;
  json.Free;
  resp.Free;

end;

// ---------------------------------------------------------------------------

begin

  try
    RunDemo;
  except
    on E: Exception do
      WriteLn('Unhandled exception: ', E.ClassName, ': ', E.Message);
  end;

  WriteLn;
  {$IFDEF MSWINDOWS}
  WriteLn('Press Enter to exit...');
  ReadLn;
  {$ENDIF}
end.