Mailman Engine API

curl -X POST https://mailman.cloudrails.in/api/v1/send \
  -H "Content-Type: application/json" \
  -H "x-api-access-code: YOUR_ACCESS_CODE" \
  -H "x-api-secret-key: YOUR_SECRET_KEY" \
  -d '{
    "to": "recipient@example.com",
    "replyTo": "support@yourdomain.com",
    "subject": "Hello from Mailman",
    "html": "<p>This is a transactional message sent via Mailman Engine.</p>",
    "trackOpens": true,
    "trackClicks": true
  }'

{
  "type": "function",
  "function": {
    "name": "send_transactional_email",
    "description": "Dispatches a transactional email through Mailman Engine gateway.",
    "parameters": {
      "type": "object",
      "properties": {
        "to": {
          "type": "string",
          "description": "Recipient email address."
        },
        "subject": {
          "type": "string",
          "description": "Concise and professional subject line."
        },
        "html": {
          "type": "string",
          "description": "Semantic HTML formatted body. Do not output markdown."
        },
        "replyTo": {
          "type": "string",
          "description": "Optional custom Reply-To email address (e.g. support@company.com)."
        },
        "trackOpens": {
          "type": "boolean",
          "description": "Whether to inject open tracking pixel."
        },
        "trackClicks": {
          "type": "boolean",
          "description": "Whether to track link clicks."
        },
        "queue": {
          "type": "boolean",
          "description": "Whether to deliver asynchronously via background queue."
        }
      },
      "required": ["to", "subject", "html"]
    }
  }
}

{
  "name": "send_transactional_email",
  "description": "Sends transactional email via Mailman Engine gateway.",
  "input_schema": {
    "type": "object",
    "properties": {
      "to": { "type": "string", "description": "Destination email address." },
      "subject": { "type": "string", "description": "Subject line." },
      "html": { "type": "string", "description": "HTML content of the email." },
      "replyTo": { "type": "string", "description": "Optional custom Reply-To email address." }
    },
    "required": ["to", "subject", "html"]
  }
}

import axios from 'axios';

export async function sendEmailNotification(to: string, subject: string, html: string) {
  const response = await axios.post(
    'https://mailman.cloudrails.in/api/v1/send',
    {
      to,
      subject,
      html,
      replyTo: 'support@yourdomain.com',
      trackOpens: true,
      trackClicks: true,
      queue: true
    },
    {
      headers: {
        'Content-Type': 'application/json',
        'x-api-access-code': process.env.MAILMAN_ACCESS_CODE!,
        'x-api-secret-key': process.env.MAILMAN_SECRET_KEY!
      }
    }
  );

  return response.data;
}

import os
import requests

def dispatch_email(recipient: str, subject: str, html_body: str, reply_to: str = None):
    url = "https://mailman.cloudrails.in/api/v1/send"
    headers = {
        "Content-Type": "application/json",
        "x-api-access-code": os.environ["MAILMAN_ACCESS_CODE"],
        "x-api-secret-key": os.environ["MAILMAN_SECRET_KEY"]
    }
    payload = {
        "to": recipient,
        "subject": subject,
        "html": html_body,
        "replyTo": reply_to or "support@yourdomain.com",
        "trackOpens": True,
        "trackClicks": True
    }
    
    res = requests.post(url, json=payload, headers=headers, timeout=15)
    res.raise_for_status()
    return res.json()

package mailman

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

type DispatchPayload struct {
	To          string `json:"to"`
	Subject     string `json:"subject"`
	HTML        string `json:"html"`
	TrackOpens  bool   `json:"trackOpens"`
	TrackClicks bool   `json:"trackClicks"`
}

func SendEmail(to, subject, html string) error {
	payload := DispatchPayload{
		To:          to,
		Subject:     subject,
		HTML:        html,
		TrackOpens:  true,
		TrackClicks: true,
	}
	body, _ := json.Marshal(payload)

	req, _ := http.NewRequest("POST", "https://mailman.cloudrails.in/api/v1/send", bytes.NewBuffer(body))
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("x-api-access-code", os.Getenv("MAILMAN_ACCESS_CODE"))
	req.Header.Set("x-api-secret-key", os.Getenv("MAILMAN_SECRET_KEY"))

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

	if resp.StatusCode != http.StatusOK && resp.StatusCode != http.StatusAccepted {
		return fmt.Errorf("dispatch returned status %d", resp.StatusCode)
	}
	return nil
}