Samva

Poll the provider for sender verification. A successful check synchronizes stored state.

email_senders_check_verification

Create a tenant-owned email template project from Samva's canonical starter, a static-profile TSX template. Returns the template id, project id, and starter entry path. Add more emails to the same project with templates_add_entry.

templates_create

Create a Standard Webhooks endpoint. Samva generates and reveals its signing secret once.

webhooks_create

Create a draft email campaign for at most 25,000 recipients: a named broadcast with inline subject + HTML (optional text fallback) or a published template, plus an audience (includeTags/contactIds as the source, optional excludeTags). It sends nothing until campaigns_schedule_run. Contacts resolve at run time. The definition freezes after the first run is created. Org-scoped automatically.

campaigns_create

Soft-delete a webhook endpoint while retained delivery history expires.

webhooks_delete

Return exact added, modified, and deleted files against the workspace Git base at expectedRevision.

templates_diff_workspace

Tear down a domain's custom tracking. Sends immediately revert to the shared tracking host; existing custom links in delivered mail stop working.

email_domains_disable_custom_tracking

Provision a custom tracking domain for a verified sending domain: open/click links redirect through the customer's own subdomain. Requires the custom_tracking_domain entitlement. Returns the DNS records the customer must create.

email_domains_enable_custom_tracking

Enable inbound receiving for exact addresses and/or the catch-all domain. This creates provider receipt-rule state.

email_domains_enable_receiving

Idempotently find an existing contact by an identifier (email, phone, WhatsApp, or external id) or create one. Returns the contact. Org-scoped automatically; do not pass an organization.

contacts_find_or_create

Get one brand by slug: its theme CSS (`@theme` variables, a dark-mode `@theme` of colors, and `@font-face` rules with https WOFF2 sources), logo assets, footer details, and digest. A template reaches the default brand with `@import "samva:brand";` in theme.css and a named one with `@import "samva:brand/<slug>";`.

brands_get

Fetch a single campaign by id, including its content, audience, policy, and status. Read-only; org-scoped automatically.

campaigns_get

Fetch a single conversation by id, including channels, status, and metrics. Read-only; org-scoped automatically.

conversations_get

Read a normalized recipient email's tracking opt-out. Missing preferences read as opted in and remain absent.

email_tracking_get_recipient

Fetch a single scheduled message by id, including its status, scheduledFor time, the pending send payload, and the delivered messageId once dispatched. Read-only; org-scoped automatically.

scheduled_messages_get

Read one template entry and its project id, TSX entry path, publication, and channel metadata.

templates_get

Read one immutable publication and its exact commit, entry path, build digests, and artifact receipts.

templates_get_publication

Get one redacted webhook endpoint.

webhooks_get

Fetch one organization-scoped email message by id. SMS and WhatsApp ids fail as not found without existence leakage.

messages_get

Get one projected sender. Cross-organization ids fail as not found without existence leakage.

email_senders_get

Get one organization-scoped sending domain and its provider-neutral DNS records.

email_domains_get

Fetch a single campaign run, including its status and progress: totalRecipients, dispatchedCount, failedCount, and skippedCount (live while the run is in flight), estimatedCompletionAt while it is sending, plus scheduledFor/startedAt/completedAt and any failureReason. A run held by domain warming also reports holdReason and holdDomainId — the domain whose Warming tab approves the next batch. Use this to watch a run progress. Read-only; org-scoped automatically.

campaigns_get_run

Read a sending domain's custom tracking state: lifecycle status, required DNS records, and certificate/CAA readiness.

email_domains_get_custom_tracking

Read a sending domain's automated warming policy: its status, every system-created 24-hour window with its allowance and policy snapshot, what campaign runs reserved and accepted, the domain's rolling bounce and complaint window with the safety verdict, any organization or provider pause, and the decision history. Decision actors are identified only as Samva or an organization member. A domain without a plan returns the evidence and plan: null. Read-only; org-scoped automatically.

email_domains_warming_get

Read the current delivery status and update timestamp for one organization-scoped email message.

messages_get_email_status

Read a compact organization-scoped proof bundle from current usage, email messages, inbound evidence, and webhook delivery metrics. It does not send or replay traffic.

email_get_launch_proof

Read the organization's email review decision, stage, stable block reason, next action, and sending-identity clearances.

email_review_get_status

Read organization-scoped email delivery statistics for an optional date range.

email_get_stats

Read the organization's independent open and click tracking defaults. Org-scoped automatically.

email_tracking_get_defaults

Read the organization's usage summary (messages sent, contacts, etc.) for a period. Read-only; org-scoped automatically.

usage_get

Read the stored sending-domain verification status without contacting the provider.

email_domains_get_status

Get dedicated pending, delivered, exhausted, and cancelled delivery counts, with the same counts per day over the last 30 days.

webhooks_get_stats

List the organization's brands, the default brand first (at most 100): slug, name, logo assets, footer details, and digest. Read one brand's theme CSS with brands_get.

brands_list

List the resolved recipients of a campaign run with their per-recipient status (pending, dispatching, dispatched, failed, skipped). Skipped recipients carry a skippedReason (e.g. unsubscribed, blocked, suppressed, no_identity) and failed recipients carry a failureReason. Optionally filter by status and page through results. Read-only; org-scoped automatically.

campaigns_list_recipients

List the runs of a campaign, most recent first, optionally filtered by run status. Read-only; org-scoped automatically.

campaigns_list_runs

List the organization's campaigns, most recent first. Optionally filter by status (draft or archived) and page through results. Read-only; org-scoped automatically.

campaigns_list

List stable delivery-event evidence for one organization-scoped email message. Provider payload metadata is omitted.

messages_list_email_events

List the organization's email messages with stable, projected evidence fields. SMS and WhatsApp records are never returned.

messages_list_email

List projected senders without stored verification tokens or organization records.

email_senders_list

List the organization's sending domains and stored verification state.

email_domains_list