Sample code for 30+ languages & platforms
PowerBuilder 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 PowerBuilder Downloads

PowerBuilder
integer li_rc
oleobject loo_Http
oleobject loo_Message
oleobject loo_FileData
long li_Loaded
oleobject loo_Response

//  Assumes Chilkat is unlocked. See Global Unlock Sample.
loo_Http = create oleobject
li_rc = loo_Http.ConnectToNewObject("Chilkat.Http")
if li_rc < 0 then
    destroy loo_Http
    MessageBox("Error","Connecting to COM object failed")
    return
end if
loo_Http.RequireSslCertVerify = 1
//  Supply a Mail Send API key from your application configuration. AuthToken adds the Bearer prefix.
loo_Http.AuthToken = "SENDGRID_API_KEY"

loo_Message = create oleobject
li_rc = loo_Message.ConnectToNewObject("Chilkat.JsonObject")

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

//  SendGrid expects the plain text alternative before HTML.
loo_Message.UpdateString("content[1].type","text/html")
loo_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~">")

loo_FileData = create oleobject
li_rc = loo_FileData.ConnectToNewObject("Chilkat.BinData")

li_Loaded = loo_FileData.LoadFile("inspection.jpg")
if li_Loaded <> 1 then
    Write-Debug "Could not read inspection.jpg. Check the path and file permissions."
    destroy loo_Http
    destroy loo_Message
    destroy loo_FileData
    return
end if

if loo_FileData.NumBytes = 0 then
    Write-Debug "inspection.jpg is empty."
    destroy loo_Http
    destroy loo_Message
    destroy loo_FileData
    return
end if

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

loo_Response = create oleobject
li_rc = loo_Response.ConnectToNewObject("Chilkat.HttpResponse")

loo_Http.HttpJson("POST","https://api.sendgrid.com/v3/mail/send",loo_Message,"application/json",loo_Response)
//  HttpJson also returns false for HTTP errors. A zero status means no HTTP response arrived.
if loo_Response.StatusCode = 0 then
    Write-Debug loo_Http.LastErrorText
    destroy loo_Http
    destroy loo_Message
    destroy loo_FileData
    destroy loo_Response
    return
end if

if loo_Response.StatusCode <> 202 then
    Write-Debug "Mail Send returned HTTP " + string(loo_Response.StatusCode)
    //  For validation errors the response body identifies the offending field and explains why.
    Write-Debug loo_Response.BodyStr
    destroy loo_Http
    destroy loo_Message
    destroy loo_FileData
    destroy loo_Response
    return
end if

Write-Debug "SendGrid accepted the email for delivery (HTTP 202)."


destroy loo_Http
destroy loo_Message
destroy loo_FileData
destroy loo_Response