Sample code for 30+ languages & platforms
Delphi DLL Requires Chilkat v11.6.0+

Outlook Mail: Send HTML Email with an Inline Image and Attachment

See more Outlook Examples

Send HTML Email with an Inline Image and Attachment using the /me/sendMail JSON action. JSON serialization handles text escaping and UTF-8. The sending mailbox comes from the authenticated user; this is not an arbitrary From-address service. saveToSentItems=true requests the sent copy.

Live send: replace recipient@example.com with an address you control. A 202 response means accepted for processing, not confirmed delivery; there is no response JSON or new message ID. Delivery can still fail later. Do not automatically repeat sendMail after a timeout, and do not rerun a successful example unless another send is intended. Mail.Send is separate from Mail.ReadWrite.

Set isInline=true and provide a contentId matching the HTML img src="cid:...". A normal attachment uses isInline=false and no CID reference. Rendering remains under the recipient mail client's control.

This demonstrates small inline attachments, encoded as base64 contentBytes. Keep individual files below 3 MB and the complete encoded JSON request comfortably below Graph's request-size limit; base64 adds roughly one third to the binary size. This example enforces a conservative 2 MB combined raw-file budget. For larger files use a draft plus an upload session (3 MB to 150 MB, subject to mailbox message-size limits), then send the draft.

Delegated permission: Mail.Send.

Uses direct Chilkat.Http calls to Microsoft Graph v1.0 for an Outlook.com or Microsoft 365 online mailbox. Save a current Graph access token as access_token in the private file qa_data/tokens/microsoftGraph.json. Obtain it through the Microsoft identity platform authorization-code flow with PKCE for a public interactive client; request offline_access if a refresh token is needed. Consent to the mail permission stated here. Tokens for SMTP/IMAP/POP, Calendar-only, or Contacts-only access are insufficient.

/me requires a signed-in user and delegated permissions. An unattended Microsoft 365 application instead uses administrator-approved application permissions and /users/{id-or-UPN}; limit it to the intended mailboxes. Client credentials is not available for personal Outlook.com mailboxes. These requests access cloud mailbox data, not local PST files, and do not require Outlook to be running. National clouds require their own authority and Graph hosts.

The code checks the HTTP status separately from transport success and validates JSON before reading it. For 401, refresh or authorize again; for 403, check consent, mailbox access, and policy; for 429, honor Retry-After with a bounded retry. A failed or timed-out write can have an uncertain outcome: reconcile before repeating it. Keep tokens, message content, continuation URLs, and detailed diagnostics private.

Microsoft documentation

Chilkat Delphi DLL Downloads

Delphi DLL
var
success: Boolean;
token: HCkJsonObject;
http: HCkHttp;
resp: HCkHttpResponse;
result: HCkJsonObject;
body: HCkJsonObject;
totalBytes: Integer;
imageData: HCkBinData;
fileData: HCkBinData;

begin
success := False;

//  Assumes Chilkat is unlocked. See Global Unlock Sample.
success := False;
//  Supply a current Microsoft Graph token with this example's mail permissions.
//  Keep the token cache private and refresh expired tokens before running the example.
token := CkJsonObject_Create();
CkJsonObject_putStrict(token,True);
success := CkJsonObject_LoadFile(token,'qa_data/tokens/microsoftGraph.json');
if (success <> True) then
  begin
    Memo1.Lines.Add('Could not read the private Graph token cache.');
    Exit;
  end;
if ((CkJsonObject_JsonTypeOf(token,'access_token') <> 1) or (CkJsonObject_StringOfEquals(token,'access_token','',True) = True)) then
  begin
    Memo1.Lines.Add('Expected a nonempty access_token in the JSON.');
    Exit;
  end;
http := CkHttp_Create();
CkHttp_putAuthToken(http,CkJsonObject__stringOf(token,'access_token'));
CkHttp_putRequireSslCertVerify(http,True);
CkHttp_putFollowRedirects(http,False);
CkHttp_putConnectTimeout(http,20);
CkHttp_putReadTimeout(http,60);
CkHttp_SetRequestHeader(http,'Accept','application/json');
resp := CkHttpResponse_Create();
result := CkJsonObject_Create();
CkJsonObject_putStrict(result,True);
//  Live send to one explicitly chosen recipient.
body := CkJsonObject_Create();
CkJsonObject_UpdateString(body,'message.subject','Sample email');
CkJsonObject_UpdateString(body,'message.body.contentType','HTML');
CkJsonObject_UpdateString(body,'message.body.content','<html><body><p>Sample HTML email.</p><img src="cid:sample-image" alt="Attached image"></body></html>');
CkJsonObject_UpdateString(body,'message.toRecipients[0].emailAddress.address','recipient@example.com');
CkJsonObject_UpdateBool(body,'saveToSentItems',True);
totalBytes := 0;
imageData := CkBinData_Create();
success := CkBinData_LoadFile(imageData,'qa_data/jpg/starfish.jpg');
if (success <> True) then
  begin
    Memo1.Lines.Add('Could not read the attachment file; no message sent.');
    Exit;
  end;
if (CkBinData_getNumBytes(imageData) > 2000000) then
  begin
    Memo1.Lines.Add('This direct-send example supports at most 2 MB of raw file data.');
    Exit;
  end;
totalBytes := totalBytes + CkBinData_getNumBytes(imageData);
if (totalBytes > 2000000) then
  begin
    Memo1.Lines.Add('Combined attachments exceed this example''s 2 MB raw-data budget.');
    Exit;
  end;
CkJsonObject_UpdateString(body,'message.attachments[0]."@odata.type"','#microsoft.graph.fileAttachment');
CkJsonObject_UpdateString(body,'message.attachments[0].name','image.jpg');
CkJsonObject_UpdateString(body,'message.attachments[0].contentType','image/jpeg');
CkJsonObject_UpdateBool(body,'message.attachments[0].isInline',True);
//  contentId matches the cid: URL in the HTML body.
CkJsonObject_UpdateString(body,'message.attachments[0].contentId','sample-image');
success := CkJsonObject_UpdateBd(body,'message.attachments[0].contentBytes','base64',imageData);
if (success <> True) then
  begin
    Memo1.Lines.Add('Could not encode the file into the JSON request.');
    Exit;
  end;
fileData := CkBinData_Create();
success := CkBinData_LoadFile(fileData,'qa_data/pdf/sample.pdf');
if (success <> True) then
  begin
    Memo1.Lines.Add('Could not read the attachment file; no message sent.');
    Exit;
  end;
if (CkBinData_getNumBytes(fileData) > 2000000) then
  begin
    Memo1.Lines.Add('This direct-send example supports at most 2 MB of raw file data.');
    Exit;
  end;
totalBytes := totalBytes + CkBinData_getNumBytes(fileData);
if (totalBytes > 2000000) then
  begin
    Memo1.Lines.Add('Combined attachments exceed this example''s 2 MB raw-data budget.');
    Exit;
  end;
CkJsonObject_UpdateString(body,'message.attachments[1]."@odata.type"','#microsoft.graph.fileAttachment');
CkJsonObject_UpdateString(body,'message.attachments[1].name','sample.pdf');
CkJsonObject_UpdateString(body,'message.attachments[1].contentType','application/pdf');
CkJsonObject_UpdateBool(body,'message.attachments[1].isInline',False);
success := CkJsonObject_UpdateBd(body,'message.attachments[1].contentBytes','base64',fileData);
if (success <> True) then
  begin
    Memo1.Lines.Add('Could not encode the file into the JSON request.');
    Exit;
  end;
success := CkHttp_HttpJson(http,'POST','https://graph.microsoft.com/v1.0/me/sendMail',body,'application/json',resp);
//  A false result can still include an HTTP error response.
if ((success <> True) and (CkHttpResponse_getStatusCode(resp) = 0)) then
  begin
    Memo1.Lines.Add('No HTTP response was received. Inspect diagnostics privately; reconcile a write before retrying.');
    Exit;
  end;
if (CkHttpResponse_getStatusCode(resp) <> 202) then
  begin
    Memo1.Lines.Add('Unexpected HTTP status: ' + IntToStr(CkHttpResponse_getStatusCode(resp)));
    Memo1.Lines.Add('Request ID: ' + CkHttpResponse__getHeaderField(resp,'request-id'));
    if (CkHttpResponse_getStatusCode(resp) = 429) then
      begin
        Memo1.Lines.Add('Retry-After: ' + CkHttpResponse__getHeaderField(resp,'Retry-After'));
      end;
    if (CkHttpResponse_getStatusCode(resp) = 401) then
      begin
        Memo1.Lines.Add('Refresh the Graph access token or authorize again.');
      end;
    Exit;
  end;
Memo1.Lines.Add('Message accepted for processing (202); delivery is not yet confirmed.');

CkJsonObject_Dispose(token);
CkHttp_Dispose(http);
CkHttpResponse_Dispose(resp);
CkJsonObject_Dispose(result);
CkJsonObject_Dispose(body);
CkBinData_Dispose(imageData);
CkBinData_Dispose(fileData);