Skip to main content

​
AhaSend CLI

A powerful command-line interface for AhaSend, the reliable transactional email service. Send emails, manage domains, configure webhooks, and monitor email analytics directly 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

Send your first email in just a few commands: 
# Authenticate with your API key
ahasend auth login

# Add and verify a domain
ahasend domains create example.com
ahasend domains verify example.com

# Send an email
ahasend messages send \
  --from [email protected] \
  --to [email protected] \
  --subject "Hello from AhaSend" \
  --text "Welcome to AhaSend!"

​
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, ARM64
  • 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

​
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

⌘I