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

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

Xbase++
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()