Skip to content

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.

Subscribe with Atom

    • 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