> ## Documentation Index
> Fetch the complete documentation index at: https://resend.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Send emails with Rust
> Learn how to send your first email using the Resend Rust SDK.
## Prerequisites
Before you start, you'll need:
* A Resend [API key](/create-an-api-key)
* A [verified domain](/add-a-domain)
## Guide
First, create a rust project with cargo and `cd` into it.
```bash theme={"theme":{"light":"github-light","dark":"vesper"}}
cargo init resend-rust-example
cd resend-rust-example
```
Next, add add the Rust Resend SDK as well as [Tokio](https://tokio.rs):
```bash theme={"theme":{"light":"github-light","dark":"vesper"}}
cargo add resend-rs
cargo add tokio -F macros,rt-multi-thread
```
The Rust SDK is Async-first so Tokio is needed.
```rust theme={"theme":{"light":"github-light","dark":"vesper"}}
use resend_rs::types::CreateEmailBaseOptions;
use resend_rs::{Resend, Result};
#[tokio::main]
async fn main() -> Result<()> {
let resend = Resend::new("re_xxxxxxxxx");
let from = "Acme ";
let to = ["delivered@resend.dev"];
let subject = "Hello World";
let email = CreateEmailBaseOptions::new(from, to, subject)
.with_html("It works!");
let _email = resend.emails.send(email).await?;
Ok(())
}
```
Instead of using `Resend::new` and hardcoding the API key, the `RESEND_API_KEY` environment variable
can be used instead. Use `Resend::default()` in that scenario instead.
Another popular option is to use a `.env` file for environment variables. You can use the
[`dotenvy`](https://crates.io/crates/dotenvy) crate for that:
```bash theme={"theme":{"light":"github-light","dark":"vesper"}}
cargo add dotenvy
```
```rust theme={"theme":{"light":"github-light","dark":"vesper"}}
// main.rs
use dotenvy::dotenv;
use resend_rs::types::CreateEmailBaseOptions;
use resend_rs::{Resend, Result};
#[tokio::main]
async fn main() -> Result<()> {
let _env = dotenv().unwrap();
let resend = Resend::default();
let from = "Acme ";
let to = ["delivered@resend.dev"];
let subject = "Hello World";
let email = CreateEmailBaseOptions::new(from, to, subject)
.with_html("It works!");
let _email = resend.emails.send(email).await?;
Ok(())
}
```
```toml theme={"theme":{"light":"github-light","dark":"vesper"}}
# .env
RESEND_API_KEY=re_xxxxxxxxx
```
## Examples
Basic email sending
Send emails with file attachments
Send emails using Resend hosted templates
Schedule emails for future delivery
Manage contacts and audiences
Create and manage sending domains
Receive and process inbound emails
Double opt-in subscription flow
Full Axum web framework application