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

Rust
// Assumes Chilkat is unlocked. See Global Unlock Sample.
let http = chilkat::Http::new();
http.set_require_ssl_cert_verify(true);
// Supply a Mail Send API key from your application configuration. AuthToken adds the Bearer prefix.
http.set_auth_token("SENDGRID_API_KEY");

let message = chilkat::JsonObject::new();
// Replace the sender with a verified sender identity and the recipient with your destination.
let _ = message.update_string("from.email", "sender@example.com");
let _ = message.update_string("personalizations[0].to[0].email", "recipient@example.com");
let _ = message.update_string("subject", "Invoice 1042");
let _ = message.update_string("content[0].type", "text/plain");
let _ = message.update_string("content[0].value", "Your invoice is attached as invoice-1042.pdf.");

let file_data = chilkat::BinData::new();
if file_data.load_file("invoice.pdf").is_err() {
    println!("Could not read invoice.pdf. Check the path and file permissions.");
    return;
}

if file_data.num_bytes() == 0 {
    println!("invoice.pdf is empty.");
    return;
}

// Encode the file bytes once. The content field contains only Base64, without a data URI prefix.
let _ = message.update_string("attachments[0].content", &file_data.get_encoded("base64").unwrap_or_default());
let _ = message.update_string("attachments[0].type", "application/pdf");
let _ = message.update_string("attachments[0].filename", "invoice-1042.pdf");
let _ = message.update_string("attachments[0].disposition", "attachment");

let response = chilkat::HttpResponse::new();
let _ = http.http_json("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.status_code() == 0 {
    println!("{}", http.last_error_text());
    return;
}

if response.status_code() != 202 {
    println!("Mail Send returned HTTP {}", response.status_code());
    // For validation errors the response body identifies the offending field and explains why.
    println!("{}", response.body_str());
    return;
}

println!("SendGrid accepted the email for delivery (HTTP 202).");