Skip to main content
The suprsend-cli skill gives your agent the complete SuprSend CLI reference so it can run commands correctly on the first try — no guessing at flags or subcommand names.

​
Installation

npx skills add https://github.com/suprsend/skills --skill suprsend-cli

​
What it enables

Full workflow lifecycle

Pull workflows from your workspace, edit locally, and push back — with --commit=true and --commit-message for version tracking.

Multi-asset management

Manage not just workflows but also schemas, events, preference categories, and translations — all from the terminal.

Cross-workspace sync

Sync notification assets between staging and production workspaces in a single command.

Type generation

Generate TypeScript, Python, Go, Java, Ruby, Swift, or Kotlin type definitions from your event schemas for type-safe integrations.

CI/CD pipelines

Configure GitHub Actions, GitLab CI, or other pipelines to pull, validate, and push notification changes automatically on merge.

Start MCP server

Start and configure the SuprSend MCP server directly from the terminal with suprsend start-mcp-server.

​
Before using the CLI

All commands require a service token. Set it as an environment variable: 
export SUPRSEND_SERVICE_TOKEN="your_service_token_here"
Always verify your active workspace before pushing: 
suprsend profile list
suprsend profile use --name <profile-name>
--workspace switches between workspaces within an account. The profile command is for self-hosted or BYOC deployments. See Setting Up CLI Access.

​
Example commands

suprsend workflow push --slug cart-abandonment --commit=true
suprsend schema push --dir ./schemas/ --commit=true
suprsend sync --source-workspace staging --target-workspace production --assets workflows,schemas
suprsend generate types --output ./types/ --language typescript

​
Common gotchas

What goes wrongWhyFix
workflow push myfile.json silently pushes 0Command expects --slug or --dir, not a file pathUse --slug or --dir suprsend/workflow/
Workflow pushed but nothing firesPushed workflows are drafts by defaultAdd --commit=true
”Successfully pushed: 0”Wrong active profile or workspaceRun suprsend profile list and switch
Validation error on pushReferenced schema or category doesn’t existPush dependencies first

​
Learn more

Run suprsend --help or suprsend <command> --help for full flag details.

Full CLI Reference

Every command, subcommand, flag, and output format.

suprsend-workflow-schema

Generate valid workflow JSON to push.