API Documentation

{
  "to_chirho": ["recipient@example.com"],     // Required: array of recipient emails
  "cc_chirho": ["cc@example.com"],            // Optional: array of CC emails
  "bcc_chirho": ["bcc@example.com"],          // Optional: array of BCC emails
  "reply_to_chirho": "replyto@example.com",   // Optional: reply-to address
  "subject_chirho": "Email Subject",          // Required: email subject
  "body_text_chirho": "Plain text body",      // Optional*: plain text version
  "body_html_chirho": "<p>HTML body</p>"      // Optional*: HTML version
}

// * At least one of body_text_chirho or body_html_chirho is required

{
  "status_chirho": "sent_chirho",
  "emails_remaining_chirho": 9999
}

{
  "error_chirho": "Invalid API key"
}

{
  "emails_remaining_chirho": 9999,
  "emails_sent_chirho": 1
}

curl -X POST https://2smtp.com/api_fe/keys_fe \
  -H "Authorization: Bearer your_session_token" \
  -H "Content-Type: application/json" \
  -d '{
    "smtp_host_chirho": "smtp.gmail.com",
    "smtp_port_chirho": 587,
    "smtp_user_chirho": "your-email@gmail.com",
    "smtp_pass_chirho": "your-app-password",
    "smtp_tls_chirho": true,
    "from_email_chirho": "your-email@gmail.com",
    "label_chirho": "Production"
  }'

curl https://2smtp.com/api_fe/keys_fe \
  -H "Authorization: Bearer your_session_token"

curl https://2smtp.com/api_fe/credits_fe \
  -H "Authorization: Bearer your_session_token"

{
  "total_credits_chirho": 10000,
  "used_credits_chirho": 500,
  "remaining_credits_chirho": 9500,
  "total_emails_sent_chirho": 500
}

curl -X POST https://2smtp.com/api_fe/send_email_fe \
  -H "X-API-Key: rk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "to_chirho": ["recipient@example.com"],
    "subject_chirho": "Hello from 2SMTP!",
    "body_text_chirho": "This is a plain text email.",
    "body_html_chirho": "<h1>Hello!</h1><p>This is an HTML email.</p>"
  }'

const response = await fetch('https://2smtp.com/api_fe/send_email_fe', {
  method: 'POST',
  headers: {
    'X-API-Key': 'rk_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    to_chirho: ['recipient@example.com'],
    subject_chirho: 'Hello from 2SMTP!',
    body_text_chirho: 'This is a plain text email.',
    body_html_chirho: '<h1>Hello!</h1><p>This is an HTML email.</p>'
  })
});

const data = await response.json();
console.log(data.status_chirho); // "sent_chirho"
console.log(data.emails_remaining_chirho); // 9999

import requests

response = requests.post(
    'https://2smtp.com/api_fe/send_email_fe',
    headers={
        'X-API-Key': 'rk_your_api_key',
        'Content-Type': 'application/json'
    },
    json={
        'to_chirho': ['recipient@example.com'],
        'subject_chirho': 'Hello from 2SMTP!',
        'body_text_chirho': 'This is a plain text email.',
        'body_html_chirho': '<h1>Hello!</h1><p>This is an HTML email.</p>'
    }
)

data = response.json()
print(data['status_chirho'])  # "sent_chirho"
print(data['emails_remaining_chirho'])  # 9999