Xbase++ Requires Chilkat v11.0.0+
Xbase++
SendGrid: Attach a PDF invoice to an email
See more SendGrid Examples
Read invoice.pdf from the working directory and send it as a downloadable file named invoice-1042.pdf. SendGrid expects Base64 file content in the JSON request, not a path or a multipart upload. The whole message, including attachments, must be under 30 MB; allow for Base64 to add about a third to the file size.
Use an API key with Mail Send permission and a verified sender identity. Replace the example addresses before sending.
SendGrid documentation: Mail Send size limits.
Chilkat Xbase++ Downloads
LOCAL oHttp
LOCAL oMessage
LOCAL oFileData
LOCAL nLoaded
LOCAL oResponse
// Assumes Chilkat is unlocked. See Global Unlock Sample.
oHttp := CreateObject("Chilkat.Http")
oHttp:RequireSslCertVerify := 1
// Supply a Mail Send API key from your application configuration. AuthToken adds the Bearer prefix.
oHttp:AuthToken := "SENDGRID_API_KEY"
oMessage := CreateObject("Chilkat.JsonObject")
// Replace the sender with a verified sender identity and the recipient with your destination.
oMessage:UpdateString("from.email", "sender@example.com")
oMessage:UpdateString("personalizations[0].to[0].email", "recipient@example.com")
oMessage:UpdateString("subject", "Invoice 1042")
oMessage:UpdateString("content[0].type", "text/plain")
oMessage:UpdateString("content[0].value", "Your invoice is attached as invoice-1042.pdf.")
oFileData := CreateObject("Chilkat.BinData")
nLoaded := oFileData:LoadFile("invoice.pdf")
IF (nLoaded != 1)
? "Could not read invoice.pdf. Check the path and file permissions."
oHttp:destroy()
oMessage:destroy()
oFileData:destroy()
RETURN
ENDIF
IF (oFileData:NumBytes == 0)
? "invoice.pdf is empty."
oHttp:destroy()
oMessage:destroy()
oFileData:destroy()
RETURN
ENDIF
// Encode the file bytes once. The content field contains only Base64, without a data URI prefix.
oMessage:UpdateString("attachments[0].content", oFileData:GetEncoded("base64"))
oMessage:UpdateString("attachments[0].type", "application/pdf")
oMessage:UpdateString("attachments[0].filename", "invoice-1042.pdf")
oMessage:UpdateString("attachments[0].disposition", "attachment")
oResponse := CreateObject("Chilkat.HttpResponse")
oHttp:HttpJson("POST", "https://api.sendgrid.com/v3/mail/send", oMessage, "application/json", oResponse)
// HttpJson also returns false for HTTP errors. A zero status means no HTTP response arrived.
IF (oResponse:StatusCode == 0)
? oHttp:LastErrorText
oHttp:destroy()
oMessage:destroy()
oFileData:destroy()
oResponse:destroy()
RETURN
ENDIF
IF (oResponse:StatusCode != 202)
? "Mail Send returned HTTP " + Str(oResponse:StatusCode)
// For validation errors the response body identifies the offending field and explains why.
? oResponse:BodyStr
oHttp:destroy()
oMessage:destroy()
oFileData:destroy()
oResponse:destroy()
RETURN
ENDIF
? "SendGrid accepted the email for delivery (HTTP 202)."
oHttp:destroy()
oMessage:destroy()
oFileData:destroy()
oResponse:destroy()