Samva Documentation
Send email and get the replies back. Task guides, the TypeScript SDK, CLI, hosted MCP, templates, and the REST API reference.
Samva is where a small business talks to its customers over email, with an AI assistant that handles the routine messages. It covers business email on your own domain in Samva Mail, the AI assistant in Samva Agents (in Preview), campaigns to your contacts, and an email API for developers who send and receive mail from code.
Business owners start with Samva Mail and Samva Agents. Developers start with Send an email and the API reference.
Find your way
Samva Agents
The AI assistant that answers your routine customer email.
Email guides
Send email: verify your domain, tune deliverability, and send.
Platform
Email messaging concepts, webhooks, campaigns, scheduling, contacts, and templates.
Developers
SDK, CLI, MCP, and REST: integrate Samva in code, plus the concepts behind it.
Email templates
Write email templates as TSX that Samva reads without running, for developers, agents, and the visual editor.
Integrations
Connect Samva to your stack and third-party services.
API Reference
Per-operation REST documentation generated from the OpenAPI spec.
How the SDK and REST API relate
There are two ways to send the same email. The TypeScript SDK exposes samva.email.send(...), an ergonomic wrapper that flattens email fields like to, subject, and html directly into the request. Under the hood, every send, whether from the SDK or a raw HTTP request, goes to POST /v1/messages. The REST endpoint takes the unified message shape, where the channel is named explicitly and email content is nested under email. The unified API concept explains why both shapes exist and when to choose each.
Support
- Status: status.samva.dev
- Email: support@samva.dev