Samva changelog: what shipped.
One entry for each thing you can now do with the email API, the SDK and CLI, hosted MCP, templates, and the dashboard. Newest first.
- sdk
Build agents with the AI SDK, Chat SDK, and Eve
Plugins for the Vercel AI SDK, Chat SDK, and Eve let your agent answer email and WhatsApp from a Samva mailbox, under the mailbox's decision rules.
Read entry- sdk
- cli
- dashboard
Give agent modules state, Workflows, and schedules
samva 0.48 and CLI 0.42 let an agent written as code keep data between calls, start Workflows, and run on a cron. Add Samva to Vercel from the dashboard.
Read entry- api
- sdk
- cli
- mcp
Read and organize Spam
Read screened email in Spam, move it to Inbox, or delete it permanently.
Read entry- sdk
- cli
- api
Write agents as code and publish them with the CLI
samva 0.47 and CLI 0.41 let you write hosted agents in TypeScript, handle mailbox and contact events, and publish versions. Agent modules replace extensions.
Read entry- api
- sdk
Check inbound mail disposition before processing
Received webhooks include disposition and reason, so your handler can distinguish delivered mail from receipt holds.
Read entry- sdk
- cli
- api
Upgrading to samva 0.37 and the CLI 0.31
samva 0.36 and 0.37 replace send modes with decision rules, delete templates permanently, and drop the RSA verifier. Upgrade the CLI and template toolchain.
Read entry- api
- cli
- dashboard
Delete templates and template projects
Permanently delete a template or a whole template project from the API, the CLI, and the dashboard. Sent-message history is kept.
Read entry- sdk
- cli
- api
Upgrading to samva 0.35 and the CLI 0.30
samva 0.31 to 0.35 reject undeclared fields, cap resource names, read threads and drafts across mailboxes, and route unknown addresses. Upgrade the CLI to 0.30.
Read entry- sdk
- cli
- api
Upgrading to samva 0.30 and the CLI 0.28
samva 0.30 passes idempotency keys as options, retries safe calls, and moves mailbox extensions onto samva/mailbox. Upgrade the CLI to 0.28.
Read entry- sdk
- cli
- api
Upgrading to samva 0.28 and the CLI 0.26
samva 0.28 replaces unsubscribe groups with topics, types query values, and adds campaign run reports. CLI releases now ship native downloads.
Read entry- sdk
- cli
- api
Upgrading to samva 0.27: changes since 0.11
Moving from samva 0.11 to 0.27 renames mailbox calls, changes contact and sender setup, and reshapes template and usage responses. Check these changes.
Read entry- api
- sdk
- cli
Add your own headers to any email you send
Pass a headers map on a send and Samva copies it onto the outgoing email, from the API, the SDK, or the CLI. Names Samva owns are rejected.
Read entry- templates
- dashboard
- mcp
Edit a template's sending defaults in the dashboard
Set a template's sender, reply-to address, and open and click tracking from the editor toolbar, or from your coding agent over hosted MCP.
Read entry- api
- sdk
Know when a mailbox email was delivered or bounced
Mailboxes publish a delivered or failed event for each recipient of an email they send, on webhooks and the event stream, typed in the SDK.
Read entry- billing
- dashboard
- api
See sending credits and AI credits as two balances
Usage shows sending credits and AI credits apart, with a meter for each and its reset date. Spending one never uses up the other.
Read entry- deliverability
- sdk
- cli
Track links from a parent of your sending domain
Sending from send.acme.com? Your tracking links can now use track.acme.com, so recipients see your main domain in every open and click link.
Read entry- cli
- templates
Make a brand the default from the command line
The CLI can now set a brand as your default and delete brands you no longer use, with a dry run first, so brand changes can live in a script.
Read entry- templates
- api
- sdk
Read compiled where template responses said ir
Template publications now return the compiled template as compiled, and a brand's footer as one rendered block. Update code that read ir or two footers.
Read entry- api
- sdk
- cli
- mcp
Give your agent its own mailbox to read and reply
Create an email address for an agent or app on samva.email or your own domain, with threads, replies, drafts, approval before sending, and quarantine.
Read entry- sdk
- cli
- api
Upgrading to samva 0.11: five changes to check
The 0.11 SDK and 0.8 CLI page lists by cursor, return smaller read models, and rename parameters. The same changes are live on the REST API.
Read entry- sdk
- cli
Use the Effect SDK with stable Effect 4.0.0
The Effect entrypoints in samva 0.10 and @samva/webhooks 0.10 need stable effect 4.0.0. The CLI bundles it, and the Promise SDK needs no Effect.
Read entry- templates
- sdk
- mcp
Push to Git, then see your changes in the editor
Opening a hosted template workspace pulls your latest pushed commits and reports conflicts. The separate reconcile step is removed.
Read entry- mcp
Check your email setup with the plugin listing
The Samva plugin for ChatGPT is published. Install it, connect one organization, and ask for a read-only readiness check or the status of your last email.
Read entry- templates
- sdk
Give your coding agent the template contract
@samva/markup ships a machine-readable contract and an sml skill, so an agent knows which template forms are valid and how to fix each error.
Read entry- deliverability
Look up a domain's MX records, no account needed
See which mail hosts receive a domain's email, and get MX results beside SPF, DKIM, and DMARC in the email authentication checker.
Read entry- sdk
- api
Match conversation senders on actorType sender
A participant sent as one of your senders now reports actorType sender, including in existing conversations. Update code that matched sender_identity.
Read entry- cli
- templates
Preview and screenshot templates from the CLI
Run the visual editor locally with no config, print a rendered fixture, or capture desktop and mobile screenshots in light and dark.
Read entry- api
- deliverability
Get webhooks for opens, clicks, and unsubscribes
Subscribe an endpoint to message.opened, message.clicked, contact.unsubscribed, and contact.resubscribed. Each is signed and retried like your delivery events.
Read entry- templates
- cli
- sdk
Publish several emails from one template project
Register more than one email in a template project. Each is its own template and publication, sharing the project's components, theme, and history.
Read entry- templates
- cli
- sdk
Add images and fonts to a template workspace
Add PNG, JPEG, GIF, WebP, and WOFF2 files to a template draft from the editor, CLI, or SDK. They're committed on the next Save.
Read entry- templates
- dashboard
- api
Set your brand once and use it in every template
Save your colors, fonts, logos, and footer as a brand, import it into any template, and republish a template when the brand changes.
Read entry- api
- dashboard
Give an API key access to only what it needs
Create a restricted API key limited to the resources you pick, each at read or write. Every key is also capped by its owner's current role.
Read entry- sdk
- cli
Manage contact groups and attachments from the SDK
Manage contact groups, custom fields, unsubscribe groups, attachments, and analytics from the SDK, with safer retries on every send.
Read entry- deliverability
- api
Send from a new account without waiting for approval
A new organization can send as soon as its domain is verified, under extra limits, and graduates on its own delivery record.
Read entry- sdk
- cli
Upgrading to samva 0.6: four changes to check
The 0.6 SDK renames a few status values and tightens error and webhook handling. Here are the four changes that can break existing code.
Read entry- deliverability
- dashboard
See exactly which DNS records will change first
Before anything is written, the domain page shows which records will be added, which already exist, and which are in the way. Approve with one button.
Read entry- deliverability
- dashboard
- api
Warm up a new sending domain automatically
Set a daily growth policy on a verified domain and campaign volume ramps up in 24-hour windows, held back if bounces or complaints climb.
Read entry- dashboard
- api
Build audiences and add custom contact fields
Group contacts into audiences that you fill or that a rule fills, and store your own fields on contacts. Both are in the dashboard and the API.
Read entry- dashboard
- api
See and cancel scheduled sends in Activity
Emails you schedule through the API, SDK, CLI, or MCP now show in a Scheduled tab under Activity, where you can cancel one before it sends.
Read entry- dashboard
- deliverability
Spot failing domains, webhooks, and keys faster
Rows in the dashboard now say whether a domain, sender, webhook, or API key needs attention, and why, before you open it. Suppressions replaces Blocks.
Read entry- templates
- sdk
- api
Catch bad template data before an email sends
A template send now checks your data against the template's input schema, so a missing or mistyped field fails the request instead of reaching a recipient.
Read entry- templates
Edit an email template with AI, no account needed
Start from a gallery template in the AI email editor, edit it visually or by asking the assistant, and export the HTML. Sign in later to keep it.
Read entry- templates
- cli
Edit email templates in Git and publish a commit
Each template project is a Git repository. Clone it, edit anywhere, push, and publish the exact commit you tested, or roll back without a deploy.
Read entry- deliverability
- dashboard
Set up your sending domain's DNS in one click
If Cloudflare or Vercel hosts your DNS, connect it from the domain page and Samva adds the records for you. Use an API token if sign-in isn't available.
Read entry- deliverability
Check SPF, DKIM, DMARC, and BIMI records for free
Look up any domain's SPF, DKIM, DMARC, or BIMI record on its own page, or run every check at once. Free, with no account needed.
Read entry- mcp
Connect an AI agent to your account over MCP
Point any MCP client at mcp.samva.dev to let an agent send and track email, manage domains and templates, and read webhook activity.
Read entry- api
- dashboard
- billing
Create an account and send your first email
Sign up, verify a sending domain, and send through the API, SDK, or CLI. The free plan needs no card, so you can try it before you pay.
Read entry- deliverability
- sdk
Serve open and click tracking from your domain
Tracked links show your own subdomain instead of a shared host. Add two DNS records, or approve them in one step where your DNS provider allows it.
Read entry- sdk
- cli
- api
Send email from TypeScript or your terminal
Install the samva package or the CLI to send email and manage domains and templates, and verify signed webhooks with @samva/webhooks.
Read entry
Related Resources
- FeatureFeaturesMailboxes your agent owns, email and WhatsApp through one API, and business email.
- DocumentationDeveloper referenceSend in one typed call. Build with your agent.
- FeaturePricingStart free with 500 emails a month. Then pay for the volume you send.
- Blog ArticleBlogPractical email engineering notes for developers.