mailgun

# Mailgun Email Sender Send emails programmatically using Mailgun's HTTP API. ## Prerequisites Configure the following environment variables in `~/.zshrc` or `~/.bash_profile`: ```bash export MAILGUN_API_KEY="key-xxxxx" # Your Mailgun private API key export MAILGUN_DOMAIN="mg.yourdomain.com" # Your Mailgun domain export MAILGUN_FROM="Sender <noreply@mg.yourdomain.com>" # Default sender export MAILGUN_DEFAULT_TO="you@email.com" # Default recipient (optional) ``` Then reload your shell configuration: ```bash source ~/.zshrc ``` ## Usage ### Send a simple email ```bash mailgun/scripts/send_email.sh "Subject" "Email body text" ``` ### Send to a specific recipient ```bash mailgun/scripts/send_email.sh "Newsletter" "Content here" "recipient@email.com" ``` ### Send with custom sender ```bash mailgun/scripts/send_email.sh "Alert" "System down" "admin@company.com" "alerts@company.com" ``` ## Features - Simple command-line interface - Uses environment variables for configuration - Supports custom sender and recipient - Returns success/error status codes - Works with HTML content (pass HTML in body parameter) ## Common Use Cases - Daily/weekly newsletters - System alerts and notifications - Automated reports - Confirmation emails - Scheduled reminders ## Troubleshooting **Error: MAILGUN_API_KEY and MAILGUN_DOMAIN must be set** → Configure environment variables as shown in Prerequisites **Error: 401 Unauthorized** → Check that your API key is correct and active **Error: 404 Not Found** → Verify your MAILGUN_DOMAIN is correct ## References - Mailgun Documentation: https://documentation.mailgun.com/ - API Reference: See [references/api.md](references/api.md)