Rust Requires Chilkat v11.0.0+
Rust
SendGrid: Send a plain text email to one recipient
See more SendGrid Examples
Send a plain text confirmation with one recipient, one subject, and one body. To try the request without sending mail, set validateOnly to true: sandbox mode returns HTTP 200 for a valid request. A normal send returns HTTP 202 when accepted; subsequent delivery is a separate event.
Use an API key with Mail Send permission and a verified sender identity. Replace the example addresses before sending.
SendGrid documentation: Sandbox mode.
Chilkat Rust Downloads
// 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", "Order confirmation");
let _ = message.update_string("content[0].type", "text/plain");
let _ = message.update_string("content[0].value", "We received your order #1042.");
// Set to true to validate the request without delivering an email.
let validate_only = false;
let _ = message.update_bool("mail_settings.sandbox_mode.enable", validate_only);
let mut expected_status = 202;
if validate_only {
expected_status = 200;
}
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() != expected_status {
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;
}
if validate_only {
println!("Sandbox validation passed. No email was sent.");
return;
}
println!("SendGrid accepted the email for delivery (HTTP 202).");