sendgrid_thin

A thin wrapper around the SendGrid V3 API.

It exposes a simple API to send emails with SendGrid with a blocking or non-blocking way.

You can use it inside your Actix, Axum or Rocket application without any problems.

To get the API key, you need to create an account on SendGrid and create an API key.

I recommend the dotenvy crate to load the API key from an environment variable.

Usage

    use sendgrid_thin::{Sendgrid, ContentType};

    #[tokio::main]
    async fn main() {
        let sendgrid = Sendgrid::builder(
                "SENDGRID_API_KEY",
                "from_email@example.com",
                ["to_email_1@example.com","to_email_2@example.com"],
                "subject of email",
                "body of email",
            )
            .set_content_type(ContentType::Html)
            .set_send_at(1668281500)
            .set_request_timeout(std::time::Duration::from_secs(10))
            .set_cc_emails(["cc_email_1@example.com", "cc_email_2@example.com"])
            .build()
            .unwrap();

        // Send the email with a non-blocking client
        match sendgrid.send().await {
            Ok(message) => println!("{message}"),
            Err(err) => println!("Error sending email: {err}"),
        }

        // Send the email with a blocking client (in this case the main function cannot be async)
        match sendgrid.send_blocking() {
            Ok(message) => println!("{message}"),
            Err(err) => println!("Error sending email: {err}"),
        }
    }

Features

Default features

• blocking - Enables the blocking client

You can disable the default features by adding the following to your Cargo.toml:

sendgrid_thin = { version = "x.x.x", default-features = false }

Or when adding the dependency via cargo add:

cargo add sendgrid_thin --no-default-features