Skip to main content

Crate paubox

Crate paubox 

Source
Expand description

§paubox

Async Rust SDK for the Paubox Email and Forms APIs. Paubox is a HITRUST-certified platform for sending HIPAA-compliant email and collecting patient data through secure forms.

§Features

FeatureDefaultDescription
email✓Paubox Email API (send messages, track delivery)
forms✓Paubox Forms API (get form definitions, submit responses)

§Quick start

§Send an email

use paubox::{PauboxClient, email::Message};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = PauboxClient::new("YOUR_API_KEY");

    let msg = Message::builder()
        .from("you@yourdomain.com")
        .to(["patient@example.com"])
        .subject("Your lab results are ready")
        .text_content("Please log in to the patient portal to view your results.")
        .build()?;

    let resp = client.send_message(&msg).await?;
    println!("Sent! Tracking ID: {}", resp.source_tracking_id);

    let disposition = client.get_email_disposition(&resp.source_tracking_id).await?;
    for d in &disposition.message_deliveries {
        println!("{}: {} ({})", d.recipient, d.delivery_status, d.opened_status);
    }
    Ok(())
}

§Submit a form

use paubox::forms::{FormsClient, FormSubmission};
use serde_json::json;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = FormsClient::new();

    let form = client.get_form("your-form-uuid").await?;
    println!("Submitting: {}", form.title);

    let submission = FormSubmission::builder()
        .form_data(json!({"first_name": "Jane", "last_name": "Doe"}))
        .build()?;
    client.submit_form("your-form-uuid", &submission).await?;
    Ok(())
}

§Credentials from environment variables

use paubox::PauboxClient;

// Reads PAUBOX_API_KEY
let client = PauboxClient::from_env().expect("credentials not set");

Re-exports§

pub use client::PauboxClient;
pub use client::PauboxClientBuilder;
pub use error::PauboxError;

Modules§

client
Core client: credential storage and shared HTTP transport.
email
Paubox Email API — send HIPAA-compliant email and track delivery.
error
Error types for the Paubox SDK.
forms
Paubox Forms API — retrieve form definitions and submit responses.
receiving
webhooks
Paubox webhooks — manage which URL Paubox notifies, for which events.