Overview
Spinupmail Documentation
API reference, deployment guidance, and operational details for running disposable email workflows on Cloudflare with organization-safe access controls.
Get Started
Install and first run.
API Reference
Authentication model and exhaustive endpoint contracts.
API Overview
Start here before using the endpoint reference pages.
Domains API
Single endpoint reference for domain selection and validation in clients.
Organizations API
Organization creation plus counts, time-series activity, and aggregate summary metrics.
Email Addresses API
Exhaustive reference for inbox lifecycle operations, including integration-enabled inbox subscriptions.
Emails API
Exhaustive reference for inbox message retrieval and cleanup.
Configuration
Cloudflare, auth, and deploy setup.
Cloudflare Resources
Create D1, KV, R2, and Durable Object bindings, then fill `wrangler.toml` with the right values.
Auth and Secrets
Set Worker secrets, local `.dev.vars`, and provider-specific callbacks so auth works cleanly on Cloudflare.
Deploy and Routing
Ship the API and UI as separate Cloudflare deploy units and wire a dedicated API subdomain plus inbound email routing.
Operations
Inbound flow and production operations.
Inbound Pipeline
Follow the full path from Email Routing intake to D1/R2 persistence.
Integrations
Configure providers, attach address subscriptions, and understand queue-backed dispatch behavior.
Multi-domain Setup
Scale to multiple domains with EMAIL_DOMAINS and per-domain routing rules.
Local Development
Use wrangler dev, `.dev.vars`, and local email handler simulation for deterministic testing.
Limits and Security
Review the live defaults for organizations, addresses, attachments, rate limiting, and org-scoped access control.

