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

SendGrid: Embed an inline image in an HTML email

See more SendGrid Examples

Read inspection.jpg from the working directory and send it with an HTML inspection report. The image travels with the message: its content_id matches the cid: reference in the HTML. Supply plain text first and include useful alt text so the result is understandable even if the mail client hides images.

Use an API key with Mail Send permission and a verified sender identity. Replace the example addresses before sending.

SendGrid documentation: Mail Send attachment fields.

Chilkat Xojo Plugin Downloads

Xojo Plugin
//  Assumes Chilkat is unlocked. See Global Unlock Sample.
Dim http As New Chilkat.Http
http.RequireSslCertVerify = True
//  Supply a Mail Send API key from your application configuration. AuthToken adds the Bearer prefix.
http.AuthToken = "SENDGRID_API_KEY"

Dim message As New Chilkat.JsonObject
//  Replace the sender with a verified sender identity and the recipient with your destination.
Dim success As Boolean
success = message.UpdateString("from.email","sender@example.com")
success = message.UpdateString("personalizations[0].to[0].email","recipient@example.com")
success = message.UpdateString("subject","Inspection photo")
success = message.UpdateString("content[0].type","text/plain")
success = message.UpdateString("content[0].value","The inspection is complete. The photo shows the repaired hinge.")

//  SendGrid expects the plain text alternative before HTML.
success = message.UpdateString("content[1].type","text/html")
success = message.UpdateString("content[1].value","<p>The inspection is complete. The photo shows the repaired hinge.</p><img src=""cid:hinge-photo"" alt=""Repaired hinge"">")

Dim fileData As New Chilkat.BinData
Dim loaded As Boolean
loaded = fileData.LoadFile("inspection.jpg")
If (loaded <> True) Then
    System.DebugLog("Could not read inspection.jpg. Check the path and file permissions.")
    Return
End If

If (fileData.NumBytes = 0) Then
    System.DebugLog("inspection.jpg is empty.")
    Return
End If

//  Encode the file bytes once. The content field contains only Base64, without a data URI prefix.
success = message.UpdateString("attachments[0].content",fileData.GetEncoded("base64"))
success = message.UpdateString("attachments[0].type","image/jpeg")
success = message.UpdateString("attachments[0].filename","inspection.jpg")
success = message.UpdateString("attachments[0].disposition","inline")
success = message.UpdateString("attachments[0].content_id","hinge-photo")

Dim response As New Chilkat.HttpResponse
success = http.HttpJson("POST","https://api.sendgrid.com/v3/mail/send",message,"application/json",response)
//  HttpJson also returns false for HTTP errors. A zero status means no HTTP response arrived.
If (response.StatusCode = 0) Then
    System.DebugLog(http.LastErrorText)
    Return
End If

If (response.StatusCode <> 202) Then
    System.DebugLog("Mail Send returned HTTP " + Str(response.StatusCode))
    //  For validation errors the response body identifies the offending field and explains why.
    System.DebugLog(response.BodyStr)
    Return
End If

System.DebugLog("SendGrid accepted the email for delivery (HTTP 202).")