ahasend messages: Send and Track Email

ahasend messages [command] [flags]

ahasend messages send [flags]

# Text email
ahasend messages send --sandbox \
  --from sender@example.com \
  --to recipient@example.com \
  --subject "Hello" \
  --text "Hello World"

# HTML email
ahasend messages send --sandbox \
  --from sender@example.com \
  --to recipient@example.com \
  --subject "Welcome" \
  --html "<h1>Welcome!</h1><p>Thank you for signing up.</p>"

# Multipart email with HTML and text
ahasend messages send --sandbox \
  --from sender@example.com \
  --to recipient@example.com \
  --subject "Welcome" \
  --html "<h1>Welcome!</h1>" \
  --text "Welcome!"

ahasend messages send --sandbox \
  --from support@example.com \
  --from-name "Example Support" \
  --reply-to help@example.com \
  --to recipient@example.com \
  --subject "Your ticket" \
  --text "We received your request."

# Several recipients
ahasend messages send --sandbox \
  --from sender@example.com \
  --to user1@example.com \
  --to user2@example.com \
  --subject "Team Update" \
  --text "Important announcement"

# Recipients file with per-recipient substitutions
ahasend messages send --sandbox \
  --from sender@example.com \
  --recipients users.csv \
  --subject "Hello {{first_name}}" \
  --html-file newsletter.html

ahasend messages send --sandbox \
  --from sender@example.com \
  --to recipient@example.com \
  --subject "Welcome {{first_name}}" \
  --html-file welcome.html \
  --text-file welcome.txt \
  --global-substitutions data.json

ahasend messages send --sandbox \
  --template-id YOUR_RESOURCE_ID \
  --recipients users.csv \
  --global-substitutions defaults.json

ahasend messages send --sandbox \
  --from sender@example.com \
  --to recipient@example.com \
  --subject "Invoice" \
  --text "Please find your invoice attached." \
  --attach invoice.pdf

ahasend messages send --sandbox \
  --from sender@example.com \
  --to recipient@example.com \
  --subject "Reminder" \
  --text "Meeting tomorrow at 2 PM" \
  --schedule 2h

ahasend messages send --sandbox \
  --from sender@example.com \
  --to recipient@example.com \
  --subject "Important Update" \
  --html-file update.html \
  --header "X-Campaign-ID: summer" \
  --tag onboarding \
  --track-clicks=false

ahasend messages send --sandbox --sandbox-result bounce \
  --from sender@example.com \
  --to test@example.com \
  --subject "Test" \
  --text "Testing"

ahasend messages send --sandbox \
  --from sender@example.com \
  --to user@example.com \
  --subject "Important" \
  --text "Message" \
  --idempotency-key "order-1234-confirmation"

Message sent to 1 of 2 recipients

Message 1:
  Recipient: u@example.com
  ID: <0d371db4-00d0-5eec-851c-e1db1e2b190d@example.com>
  Status: queued

Message 2:
  Recipient: rej@example.com
  Status: error
  Error: failed to send message: rej@example.com: The message could not be queued because of an internal error. Please try again later or contact support.

ahasend messages list [flags]

# List recent messages
ahasend messages list

# Messages from the last 24 hours that bounced or failed
ahasend messages list --from-time 24h --status bounced --status failed

# Messages to every address at one domain
ahasend messages list --recipient @example.com

# Messages with a tag
ahasend messages list --tag onboarding --limit 50

ahasend messages get <message-id> [flags]

ahasend messages get "YOUR_RESOURCE_ID"

# Save the message content to a file
ahasend messages get "YOUR_RESOURCE_ID" --output json | jq -r .content > message.txt

ahasend messages cancel <message-id>... [flags]

# Schedule a sandbox message, then cancel it by its Message-ID
TEST_ID=$(ahasend messages send --sandbox \
  --from sender@example.com \
  --to test@example.com \
  --subject "Cancellation test" \
  --text "Test" \
  --schedule 1h \
  --output json | jq -er '.data[0].id')

# Wait for the API to record the message
sleep 10
ahasend messages cancel "$TEST_ID" --force