Smtp Transactional

SMTP Transactional Email

This skill covers sending transactional emails via SMTP and managing delivery infrastructure.

Available Tools

Sending

Bounces

Unsubscribes

Infrastructure

Sending Transactional Emails

Send Email

Tool: smtp_emails_send
Input: {
  "email": {
    "subject": "Order Confirmation #12345",
    "from": {"name": "Acme Store", "email": "orders@acme.com"},
    "to": [{"name": "John Doe", "email": "john@example.com"}],
    "html": "<h1>Thank you for your order!</h1><p>Order #12345 confirmed.</p>"
  }
}

Returns message ID for tracking delivery.

List Sent Emails

Tool: smtp_emails_list
Input: {"limit": 50, "offset": 0}

Returns sent emails with delivery status, timestamps, and IDs.

Get Email Details

Tool: smtp_emails_show
Input: {"id": "<email-id>"}

Returns full delivery details including opens, clicks, and status.

Total Sent Count

Tool: smtp_emails_total
Input: {}

Returns total number of SMTP emails sent.

Bounce Management

List Recent Bounces

Tool: smtp_bounces_list
Input: {}

Returns bounced emails from the last 24 hours with bounce type and reason.

Get Bounce Count

Tool: smtp_bounces_total
Input: {}

Returns total number of bounced emails.

Unsubscribe Management

Check Unsubscribe Status

Tool: smtp_unsubscribes_is_unsubscribed
Input: {"email": "user@example.com"}

Returns true/false — always check before sending.

List Unsubscribed

Tool: smtp_unsubscribes_list
Input: {"limit": 100, "offset": 0}

Returns all unsubscribed email addresses.

Unsubscribe an Email

Tool: smtp_unsubscribes_create
Input: {"emails": ["user@example.com"]}

Prevents future SMTP emails to this address.

Re-subscribe

Tool: smtp_unsubscribes_resubscribe
Input: {"email": "user@example.com"}

Allows sending again — use only with explicit consent.

Remove from Unsubscribe List

Tool: smtp_unsubscribes_delete
Input: {"emails": ["user@example.com"]}

Alternative to resubscribe.

Infrastructure Configuration

List Dedicated IPs

Tool: smtp_ips_list
Input: {}

Returns allocated IP addresses for SMTP sending.

List SMTP Senders

Tool: smtp_senders_list
Input: {}

Returns configured SMTP sender email addresses.

Add SMTP Sender

Tool: smtp_senders_create
Input: {"email": "transactional@acme.com"}

List Sender Domains

Tool: smtp_senders_domains_list
Input: {}

Returns domains authorized for SMTP sending.

Add Sender Domain

Tool: smtp_senders_domains_create
Input: {"domain": "acme.com"}

Adds domain — requires DNS verification (SPF/DKIM).

Common Workflows

Send Order Confirmation

1. smtp_unsubscribes_is_unsubscribed(email) -> Check not unsubscribed
2. smtp_emails_send(subject, from, to, html) -> Send email
3. smtp_emails_show(message_id) -> Verify delivery

Monitor Delivery Health

1. smtp_bounces_total() -> Check bounce rate
2. smtp_bounces_list() -> Review recent bounces
3. smtp_unsubscribes_list() -> Review unsubscribes
4. email_blacklist_emails_add(emails) -> Blacklist hard bounces

Set Up SMTP Infrastructure

1. smtp_senders_domains_create(domain) -> Add domain
2. (Configure SPF/DKIM in DNS)
3. smtp_senders_create(email) -> Add sender
4. smtp_senders_list() -> Verify setup
5. smtp_ips_list() -> Check dedicated IPs

Best Practices

1. Check unsubscribe status before sending transactional emails
2. Monitor bounces daily and blacklist hard bounces
3. Use dedicated IPs for better deliverability reputation
4. Set up SPF/DKIM on sender domains for authentication
5. Keep sender domains consistent with your brand
6. Re-subscribe only with explicit consent to comply with regulations
7. Use HTML templates with plain text fallback for maximum compatibility