Command line

sevk fromyour terminal.

Send emails, manage domains, contacts, audiences, broadcasts, and templates. Interactive for humans, --json for pipes and CI.

Install

$npm install -g sevk-cli

Documentation

Capabilities

Built for
developers.

Same auth model, same output formats across every command. Works in CI, in agent tool calls, in shell scripts.

Full API access

Send emails, manage domains, contacts, audiences, broadcasts, and templates all from your terminal.

Secure authentication

Multi-profile support with API key resolution via flag, environment variable, or config file.

CI/CD ready

Pass --json on any command for structured JSON output. Perfect for pipelines.

Global options

Override API keys, switch profiles, force JSON output, or set a custom base URL on any command.

sevk Markup support

Render sevk Markup to HTML directly. Pipe markup files or pass them inline.

Built-in diagnostics

Run sevk doctor to verify your setup, version, runtime, API key, and connectivity in seconds.

Commands

Common
commands.

Run any command with --help for full flags. Append --json to force structured output.

sevk loginAuthenticate with your API key

sevk emails sendSend a transactional email

sevk domains listList sending domains

sevk contacts listList contacts in an audience

sevk audiences listList audiences

sevk broadcasts sendSend a broadcast by ID

sevk templates listList email templates

sevk webhooks listList webhook subscriptions

sevk activity listList activity log entries

sevk markup renderRender sevk Markup to HTML

sevk doctorCheck your environment

Automation

Built for
automation.

Drop the CLI into any CI/CD pipeline or let AI agents call it as a subprocess. Pass --json and every command returns structured JSON.

CI/CD pipelines

.github/workflows/notify.yml

name: Send deploy notification

on:
  push:
    branches: [main]

jobs:
  notify:
    runs-on: ubuntu-latest
    steps:
      - run: npm install -g sevk-cli
      - run: |
          sevk emails send \
            --from "deploy@yourdomain.com" \
            --to "team@yourdomain.com" \
            --subject "Deploy complete"
        env:
          SEVK_API_KEY: ${{ secrets.SEVK_API_KEY }}

UTF-8LFSpaces: 2

18 linesYAML

Set SEVK_API_KEY as a secret, no login step needed
Returns structured JSON output with the --json flag
Exit code 0 on success, 1 on error, works with any CI runner

AI agents

agent-call.sh

# AI agents call the CLI as a subprocess.
# Pass --json to get a structured JSON response.

sevk emails send \
  --from "agent@yourdomain.com" \
  --to "user@example.com" \
  --subject "Your report is ready" \
  --html "<h1>Report</h1>" \
  --json

# Parse the JSON response
sevk contacts list --audience aud_xxx | jq '.[].email'
# "alice@example.com"
# "bob@example.com"
# "carol@example.com"