API Documentation

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

// * At least one of body_text or body_html is required

{
  "success": true,
  "recipients": 1,
  "credits_remaining": 9999
}

{
  "error": "invalid_api_key"
}

{
  "api_key_chirho": "rk_the_key_to_test",
  "to_email_chirho": "you@example.com"
}

{
  "total_credits_chirho": 10000,
  "used_credits_chirho": 1,
  "remaining_credits_chirho": 9999,
  "total_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"

{
  "daily_usage_chirho": [{ "date_chirho": "2026-07-16", "emails_chirho": 120 }],
  "total_30_days_chirho": 1830,
  "key_stats_chirho": [{ "api_key_preview_chirho": "rk_9c5c...", "label_chirho": "Production", "emails_sent_chirho": 1830 }]
}

curl -X POST https://2smtp.com/api/v1/send \
  -H "X-API-Key: rk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["recipient@example.com"],
    "subject": "Hello from 2SMTP!",
    "body_text": "This is a plain text email.",
    "body_html": "<h1>Hello!</h1><p>This is an HTML email.</p>"
  }'

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

const data = await response.json();
console.log(data.success); // true
console.log(data.recipients); // 1
console.log(data.credits_remaining); // 9999

import requests

response = requests.post(
    'https://2smtp.com/api/v1/send',
    headers={
        'X-API-Key': 'rk_your_api_key',
        'Content-Type': 'application/json'
    },
    json={
        'to': ['recipient@example.com'],
        'subject': 'Hello from 2SMTP!',
        'body_text': 'This is a plain text email.',
        'body_html': '<h1>Hello!</h1><p>This is an HTML email.</p>'
    }
)

data = response.json()
print(data['success'])  # True
print(data['recipients'])  # 1
print(data['credits_remaining'])  # 9999

<?php
$ch = curl_init('https://2smtp.com/api/v1/send');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-API-Key: rk_your_api_key',
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'to' => ['recipient@example.com'],
        'subject' => 'Hello from 2SMTP!',
        'body_text' => 'Sent from PHP with one HTTP call.'
    ])
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

echo $data['success'] ? 'sent' : $data['error'];
echo $data['credits_remaining'];

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	payload, _ := json.Marshal(map[string]any{
		"to":        []string{"recipient@example.com"},
		"subject":   "Hello from 2SMTP!",
		"body_text": "Sent from Go with one HTTP call.",
	})
	req, _ := http.NewRequest("POST", "https://2smtp.com/api/v1/send", bytes.NewReader(payload))
	req.Header.Set("X-API-Key", "rk_your_api_key")
	req.Header.Set("Content-Type", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data struct {
		SuccessChirho          bool `json:"success"`
		RecipientsChirho       int  `json:"recipients"`
		CreditsRemainingChirho int  `json:"credits_remaining"`
	}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data.SuccessChirho, data.CreditsRemainingChirho)
}

require 'net/http'
require 'json'

uri = URI('https://2smtp.com/api/v1/send')
request = Net::HTTP::Post.new(uri)
request['X-API-Key'] = 'rk_your_api_key'
request['Content-Type'] = 'application/json'
request.body = {
  to: ['recipient@example.com'],
  subject: 'Hello from 2SMTP!',
  body_text: 'Sent from Ruby with one HTTP call.'
}.to_json

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

data = JSON.parse(response.body)
puts data['success']
puts data['credits_remaining']

// Before: nodemailer needs an SMTP connection from your runtime -
// a problem on serverless platforms with no raw TCP (Workers, Edge).
//
// const transporter = nodemailer.createTransport({ host, port, auth });
// await transporter.sendMail({ from, to, subject, text });

// After: same SMTP server, but 2SMTP holds the connection - your code
// is one fetch that works anywhere JavaScript runs.
await fetch('https://2smtp.com/api/v1/send', {
  method: 'POST',
  headers: { 'X-API-Key': 'rk_your_api_key', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    to: ['recipient@example.com'],
    subject: 'Hello from 2SMTP!',
    body_text: 'No SMTP client library required.'
  })
});