> ## 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 Axum
> Send your first email using Axum and 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
Get the Resend Rust SDK and the [Tokio](https://tokio.rs) runtime.
```bash theme={"theme":{"light":"github-light","dark":"vesper"}}
cargo add resend-rs
cargo add tokio -F macros,rt-multi-thread
```
```rust theme={"theme":{"light":"github-light","dark":"vesper"}}
use std::sync::Arc;
use axum::{extract::State, http::StatusCode, routing::get, Router};
use resend_rs::types::CreateEmailBaseOptions;
use resend_rs::{Resend, Result};
// Cloning the Resend client is fine and cheap as the internal HTTP client is
// not cloned.
#[derive(Clone)]
struct AppState {
resend: Resend,
}
#[tokio::main]
async fn main() {
let shared_state = Arc::new(AppState {
resend: Resend::new("re_xxxxxxxxx"),
});
// build our application with a single route
let app = Router::new()
.route("/", get(endpoint))
// provide the state so the router can access it
.with_state(shared_state);
// run our app with hyper, listening globally on port 3000
let listener = tokio::net::TcpListener::bind("0.0.0.0:3000").await.unwrap();
axum::serve(listener, app).await.unwrap();
}
async fn endpoint(State(state): State>) -> Result {
let from = "Acme ";
let to = ["delivered@resend.dev"];
let subject = "Hello World";
let email = CreateEmailBaseOptions::new(from, to, subject)
.with_html("It works!");
// access the state via the `State` extractor and handle the error
match state.resend.emails.send(email).await {
Ok(email) => Ok(email.id.to_string()),
Err(_) => Err(StatusCode::INTERNAL_SERVER_ERROR),
}
}
```
Opening your browser at `http://localhost:3000` (or running `curl localhost:3000`) sends an
email and returns its id!
## Examples
Full Axum web framework application
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