ahasend smtp: SMTP Credentials and Test Sends

Create, list, and delete AhaSend SMTP relay credentials from the CLI, and send test emails through send.ahasend.com on port 587 to verify your setup.

Manage SMTP credentials for sending emails through AhaSend’s SMTP service.

Before running the examples, log in with a full API key, use your verified sender domain, and replace YOUR_RESOURCE_ID with a resource UUID from your test account. Create any named template, recipient, attachment, or JSON files first. Shell examples use Bash; examples that read JSON with jq need jq installed. Sends use sandbox mode.

Overview

ahasend smtp [subcommand] [flags]

Available subcommands:

• list - List all SMTP credentials
• create - Create a new SMTP credential
• get - Get details of a specific SMTP credential
• delete - Delete an SMTP credential
• send - Send an email via SMTP protocol

SMTP credentials allow you to send emails using standard SMTP protocol through any email client or application that supports SMTP. This is useful for integrating AhaSend with legacy systems, mail servers, or applications that only support SMTP.

Use SMTP credentials to:

• Send emails from email clients (Outlook, Thunderbird, etc.)
• Integrate with applications that only support SMTP
• Use AhaSend from programming languages without SDK support
• Send transactional emails from servers that support STARTTLS and AUTH PLAIN

List SMTP Credentials

ahasend smtp list

Create SMTP Credential

# Global SMTP credential
ahasend smtp create --name "Main Server" --scope global

# Domain-specific credential
ahasend smtp create \
  --name "Notifications" \
  --scope scoped \
  --domains "notifications.example.com"

# Sandbox credential for testing
ahasend smtp create \
  --name "Development" \
  --scope global \
  --sandbox

Get SMTP Details

ahasend smtp get YOUR_RESOURCE_ID

Delete SMTP Credential

TEST_ID=$(ahasend smtp create --name "Docs deletion test" --sandbox --non-interactive --output json | jq -er '.id')
ahasend smtp delete "$TEST_ID"

Send via SMTP

Send email using SMTP protocol for testing:

Set SMTP_USERNAME and SMTP_PASSWORD in your shell from the values returned when you created the sandbox credential. The CLI cannot retrieve an existing credential’s password from its ID; pass both values explicitly.

# Basic SMTP send
ahasend smtp send --sandbox \
  --username "$SMTP_USERNAME" \
  --password "$SMTP_PASSWORD" \
  --from [e-mail] \
  --to [e-mail] \
  --subject "SMTP Test" \
  --text "Testing SMTP sending"

# Test SMTP connection
ahasend smtp send \
  --test \
  --username "$SMTP_USERNAME" \
  --password "$SMTP_PASSWORD" \
  --server send.ahasend.com:587 \
  --from [e-mail] \
  --to [e-mail] \
  --subject "Connection test" \
  --text "This message is built but not sent"

Each SMTP credential provides:

• Username and password for authentication
• Scope (global or domain-specific)
• Sandbox mode option for testing
• Standard SMTP server configuration

Next Steps

• Send messages via API
• Manage API keys

Command Flags

These flags come from the current CLI. All commands also accept the global flags.

smtp create

Flag	Description and default
--domains strings	Allowed domains for scoped credentials (comma-separated)
--name string	Credential name (required)
--non-interactive	Disable interactive prompts
--sandbox	Create as sandbox credential for testing
--scope string	Credential scope (global or scoped) (default “global”)

smtp delete

Flag	Description and default
--force	Skip confirmation prompt

smtp get

This command has no command-specific flags. See global flags.

smtp list

Flag	Description and default
--cursor string	Pagination cursor for continued results
--limit int32	Maximum number of credentials to return (1-100) (default 50)

smtp send

Flag	Description and default
--attach strings	File attachments (can be used multiple times)
--bcc strings	BCC recipients
--cc strings	CC recipients
--credential-id string	Use specific SMTP credential by ID
--from string	From email address
--header strings	Custom headers (format: ‘Name: value’)
--html string	HTML content
--html-file string	Read HTML content from file
--password string	SMTP password
--sandbox	Send in sandbox mode
--sandbox-result string	Sandbox result simulation: deliver, bounce, defer, fail, or suppress (only used with —sandbox) (default “deliver”)
--server string	SMTP server address (default “send.ahasend.com:587”)
--subject string	Email subject
--tags strings	Message tags
--test	Test SMTP connection and message building (don’t send email)
--text string	Plain text content
--text-file string	Read text content from file
--to strings	Recipient email addresses (can be used multiple times)
--track-clicks	Enable click tracking
--track-opens	Enable open tracking
--username string	SMTP username (uses credential from account if not provided)

Related Guides

• Install the CLI, CLI authentication, SMTP credential setup.
• SMTP credential API, SMTP settings, CLI configuration and output.
• API authentication, Permission scopes, Domain setup.
• Sandbox behavior, Tracking setup.