email-ses-sender

Description

Send templated emails via AWS SES (Simple Email Service). Supports email templates, variables, and sandbox testing mode.

Inputs

{
  "to": "Recipient email",
  "subject": "Email subject",
  "template": "Template name",
  "variables": {}
}

Outputs

{
  "ok": true,
  "data": {
    "message_id": "Email message ID",
    "status": "sent"
  }
}

Usage

Demo Mode

python scripts/main.py --demo

Send Email

echo '{"to":"user@example.com","subject":"Hello","template":"welcome"}' | python3 scripts/main.py

Examples

Example 1: Send Email to test@sambitsargam.in

$ echo '{"to":"test@sambitsargam.in","subject":"Test Email","template":"notification","variables":{"message":"This is a test email"}}' | python3 scripts/main.py
{
  "ok": true,
  "data": {
    "message_id": "0000014a-aee4-4a01-a640-a8f7f5bd5e7e-000001",
    "status": "sent",
    "recipient": "test@sambitsargam.in",
    "timestamp": "2026-02-07T10:15:30Z"
  }

Example 2: Send Email to sambitsargam2003@gmail.com

$ echo '{"to":"sambitsargam2003@gmail.com","subject":"Important Update","template":"alert","variables":{"alert_type":"system","severity":"high"}}' | python3 scripts/main.py
{
  "ok": true,
  "data": {
    "message_id": "0000014a-aee4-4a01-a640-a8f7f5bd5e7e-000001",
    "status": "sent",
    "recipient": "sambitsargam2003@gmail.com",
    "timestamp": "2026-02-07T10:15:35Z"
  }
}

Error Handling

When an error occurs, the skill returns:

{
  "ok": false,
  "error": "Error description",
  "details": {
    "to": "Invalid email address"
  }
}