Sample code for 30+ languages & platforms
PureBasic Requires Chilkat v11.0.0+

Send HTML Email with an Inline Image from Memory

See more SMTP Examples

Add an image already held in a BinData object, use the returned Content-ID in HTML, and send the message with Microsoft 365 OAuth2. The file load represents any application source of image bytes. This sends a real message. Replace the recipient with an address you control.

Microsoft 365 work/school: The account needs an Exchange Online mailbox. SMTP submission uses smtp.office365.com:587 with STARTTLS. An administrator must allow SMTP AUTH for the mailbox under the tenant's security policy; a valid OAuth token cannot enable a disabled protocol. Security defaults can block SMTP AUTH: have the administrator choose an approved configuration or mail API rather than disabling protections just to run a sample. See SMTP AUTH settings. Personal Outlook.com accounts instead use smtp-mail.outlook.com and delegated user authorization.

First authorize the account with https://outlook.office.com/SMTP.Send and offline_access, then refresh the access token when needed. This example reads qa_data/tokens/office365.json from a private working directory. Microsoft Graph permissions such as Mail.Send or Mail.Read do not authorize these mail protocols. Do not print tokens or authentication logs.

Microsoft reference documentation

Chilkat PureBasic Downloads

PureBasic
IncludeFile "CkBinData.pb"
IncludeFile "CkStringBuilder.pb"
IncludeFile "CkJsonObject.pb"
IncludeFile "CkEmail.pb"
IncludeFile "CkMailMan.pb"

Procedure ChilkatExample()

    success.i = 0

    ;  Assumes Chilkat is unlocked. See Global Unlock Sample.

    token.i = CkJsonObject::ckCreate()
    If token.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkJsonObject::ckLoadFile(token,"qa_data/tokens/office365.json")
    If success <> 1
        Debug "Could not read qa_data/tokens/office365.json from the private working directory."
        CkJsonObject::ckDispose(token)
        ProcedureReturn
    EndIf

    If (CkJsonObject::ckJsonTypeOf(token,"access_token") <> 1) OR (CkJsonObject::ckStringOfEquals(token,"access_token","",1) = 1)
        Debug "An OAuth access token is required. Authorize or refresh the account first."
        CkJsonObject::ckDispose(token)
        ProcedureReturn
    EndIf

    mailbox.s = "user@example.com"
    mailman.i = CkMailMan::ckCreate()
    If mailman.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkMailMan::setCkSmtpHost(mailman, "smtp.office365.com")
    CkMailMan::setCkSmtpPort(mailman, 587)
    CkMailMan::setCkSmtpSsl(mailman, 0)
    CkMailMan::setCkStartTLS(mailman, 1)
    CkMailMan::setCkRequireSslCertVerify(mailman, 1)
    ;  Microsoft SMTP submission uses STARTTLS on port 587, not implicit TLS on 465.
    CkMailMan::setCkSmtpUsername(mailman, mailbox)
    CkMailMan::setCkSmtpPassword(mailman, "")
    CkMailMan::setCkOAuth2AccessToken(mailman, CkJsonObject::ckStringOf(token,"access_token"))

    email.i = CkEmail::ckCreate()
    If email.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkEmail::setCkFrom(email, mailbox)
    CkEmail::setCkSubject(email, "Sample HTML message")
    success = CkEmail::ckAddTo(email,"Recipient","recipient@example.net")
    If success <> 1
        Debug "Could not add the recipient."
        CkJsonObject::ckDispose(token)
        CkMailMan::ckDispose(mailman)
        CkEmail::ckDispose(email)
        ProcedureReturn
    EndIf

    imageData.i = CkBinData::ckCreate()
    If imageData.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkBinData::ckLoadFile(imageData,"qa_data/jpg/starfish.jpg")
    If success <> 1
        Debug "Could not load the image bytes."
        CkJsonObject::ckDispose(token)
        CkMailMan::ckDispose(mailman)
        CkEmail::ckDispose(email)
        CkBinData::ckDispose(imageData)
        ProcedureReturn
    EndIf

    contentId.s = CkEmail::ckAddRelatedBd(email,"starfish.jpg",imageData)
    If (CkEmail::ckLastMethodSuccess(email) <> 1) OR (contentId = "")
        Debug "Could not add the related MIME item."
        CkJsonObject::ckDispose(token)
        CkMailMan::ckDispose(mailman)
        CkEmail::ckDispose(email)
        CkBinData::ckDispose(imageData)
        ProcedureReturn
    EndIf

    html.i = CkStringBuilder::ckCreate()
    If html.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkStringBuilder::ckAppend(html,"<html><body><p>Sample text.</p><img src=" + Chr(34) + "cid:CONTENT_ID" + Chr(34) + " alt=" + Chr(34) + "Inline image" + Chr(34) + "></body></html>")
    replaced.i = CkStringBuilder::ckReplace(html,"CONTENT_ID",contentId)
    If replaced <> 1
        Debug "Could not insert the related Content-ID."
        CkJsonObject::ckDispose(token)
        CkMailMan::ckDispose(mailman)
        CkEmail::ckDispose(email)
        CkBinData::ckDispose(imageData)
        CkStringBuilder::ckDispose(html)
        ProcedureReturn
    EndIf

    CkEmail::ckSetHtmlBody(email,CkStringBuilder::ckGetAsString(html))
    ;  This sends a real message. Replace the recipient with an address you control.
    success = CkMailMan::ckSendEmail(mailman,email)
    If success <> 1
        CkMailMan::ckCloseSmtpConnection(mailman)
        Debug "SMTP send failed. Check the token, mailbox, recipient, and SMTP AUTH policy."
        ;  Inspect LastErrorText privately if needed; do not publish authentication/session logs.
        ;  A lost connection after DATA can leave acceptance uncertain. Avoid blindly retrying.
        CkJsonObject::ckDispose(token)
        CkMailMan::ckDispose(mailman)
        CkEmail::ckDispose(email)
        CkBinData::ckDispose(imageData)
        CkStringBuilder::ckDispose(html)
        ProcedureReturn
    EndIf

    success = CkMailMan::ckCloseSmtpConnection(mailman)
    If success <> 1
        Debug "Microsoft accepted the message, but closing the connection failed. Do not resend it."
        CkJsonObject::ckDispose(token)
        CkMailMan::ckDispose(mailman)
        CkEmail::ckDispose(email)
        CkBinData::ckDispose(imageData)
        CkStringBuilder::ckDispose(html)
        ProcedureReturn
    EndIf

    Debug "Microsoft accepted the message for delivery."


    CkJsonObject::ckDispose(token)
    CkMailMan::ckDispose(mailman)
    CkEmail::ckDispose(email)
    CkBinData::ckDispose(imageData)
    CkStringBuilder::ckDispose(html)


    ProcedureReturn
EndProcedure