Samva Documentation

Build email with Samva through task guides, SDKs, integrations, SML, and the REST API reference.

Samva is a modern email API and dashboard for product teams. Send transactional, scheduled, and campaign email through a type-safe TypeScript SDK, a CLI, an MCP server, or REST. Manage contacts, keep replies threaded into conversations, and receive delivery and inbound events over webhooks.

Find your way

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

On this page