Samva Documentation
Email and WhatsApp for AI agents. Task guides, the TypeScript SDK, CLI, hosted MCP, templates, and the REST API reference.
Samva is email and WhatsApp for AI agents: an agent gets its own address and WhatsApp number, sends and receives through one API, and works under approval rules a person controls. It also covers business email on your own domain in Samva Mail, the hosted AI assistant in Samva Agents, campaigns to your contacts, and the email API for developers who send and receive mail from code.
Agent builders start with mailboxes and onboarding customers' WhatsApp numbers. Businesses 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 and WhatsApp messages.
Email guides
Send email: verify your domain, tune deliverability, and send.
Platform
The messaging model, 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