Skip to main content
The AhaSend CLI lets you send email, manage domains and credentials, and test webhooks and routes from your terminal.
The AhaSend CLI is available on GitHub and supports Linux, macOS, and Windows.

​
Key Features

Email Sending

Send single or batch emails with templates, attachments, and scheduling

Domain Management

Add, verify, and manage sending domains with DNS configuration

Webhook Management

Configure, test, and monitor real-time event notifications

Analytics

Comprehensive email statistics and reporting

​
Why Use the CLI?

The AhaSend CLI provides several advantages:
  • Automation-Ready: Perfect for CI/CD pipelines and scripted workflows
  • Batch Processing: High-performance concurrent operations with progress tracking
  • Multiple Output Formats: JSON, table, CSV, and plain text for different use cases
  • Profile Management: Easily switch between production, staging, and development environments
  • Interactive Testing: Built-in webhook listeners and route testing for development
  • Debug Support: Comprehensive logging for troubleshooting

​
Quick Example

First add a sending domain and configure its DNS records. Replace example.com below with that verified domain, then send a sandbox email:

​
Core Capabilities

​
Email Operations

  • Send single or batch emails with templates
  • Support for HTML, plain text, and AMP content
  • Attachment handling up to 10MB per file
  • Scheduled delivery with timezone support
  • Sandbox mode for testing without sending

​
Domain Management

  • Add and configure sending domains
  • Automatic DNS record generation
  • Domain verification status tracking
  • SPF, DKIM, and DMARC configuration

​
Webhook & Route Management

  • Real-time webhook event listeners
  • Development webhook testing and triggering
  • Inbound email route configuration
  • WebSocket-based event streaming

​
Analytics & Reporting

  • Deliverability statistics
  • Bounce rate analysis
  • Delivery time metrics
  • Export to CSV for further analysis

​
Supported Platforms

The CLI is distributed as a single binary with no external dependencies:
  • Linux: x86_64 prebuilt; ARM64 via go install or a source build
  • macOS: Intel and Apple Silicon
  • Windows: x86_64

​
Integration with AhaSend Services

The CLI seamlessly integrates with all AhaSend services:
  • API: Full compatibility with AhaSend API v2
  • SMTP: Credential management and testing
  • Webhooks: Real-time event processing
  • Routes: Inbound email handling
  • Suppressions: List management

​
More Command Groups

  • Contacts: create, update, list, get, delete, and batch-import account contacts (development build; see the page for availability).
  • Sub-accounts: manage child accounts, usage, suspension, and their API keys.

​
Next Steps

Installation

Install the CLI on your system

Quick Start

Send your first email in minutes

Authentication

Set up API credentials

Command Reference

Explore available commands

​
Support