Projects & APIs

Manage projects, API access credentials, rate limits, and routing

/

ID: Copied!

This project supports single or multiple customized APIs. Each API has a distinct Access Code (*@mailman), Secret Key, dedicated quotas, burst rate limit, and upstream server routing.

In-App Credentials & Quick Connect

Use these credentials and live code snippets to connect any frontend or backend application to Mailman.

Active Credential: Code snippets below will automatically use this credential.

API Endpoint & Required Headers

POST

Header: x-api-access-code

Header: x-api-secret-key

Request Body Payload Schema (JSON)

Field	Type	Required	Description
to	string	Yes	Recipient email address (e.g. user@domain.com)
subject	string	Yes	Subject line (supports mustache tags e.g. {{name}})
html	string	Optional	HTML email body content (auto-tracks clicks & opens)
variables	object	Optional	Key-value dictionary for dynamic variable injection
queue	boolean	Optional	Defaults to false (instant send). Set true for asynchronous background worker queueing.

Project Configuration

Manage project name, default routing server, and view system identifiers.

Project ID (System Allotted)

This unique identifier is automatically allotted by Mailman and cannot be altered.

Project Name *

Description

Default Routed Mail Server

APIs in this project default to this upstream server unless explicitly overridden.

Settings saved successfully.

Generate API Key

Generate and allot a new API key with custom access code, dedicated daily quotas, and server routing for this project.

API Key Generated Successfully!

Access Code

Secret Key (Save Now)

API Key Name *

Custom Access Code (Optional)

If omitted, auto-generated. Automatically appends @mailman.

Daily Limit (emails/day)

Rate Limit (req/min)

Target Mail Server Override (Optional)

Danger Zone

Permanently delete this project and revoke all associated API credentials.

Customize API name, access code (*@mailman), daily quotas, burst rate limits, and upstream server routing override.

API Key Name

Access Code (Account Key)

Normalized automatically to name@mailman format.

Secret Key

Daily Limit (emails/day)

Rate Limit (req/min)

Target Mail Server Override

Enable this API Key for dispatching requests

Upstream Mail Servers

Multi-provider connectors: Resend, Brevo, SendGrid, Postmark, AWS SES, and Custom SMTP

Server & Provider Sender Email Daily Sent / Limit Actions

Configure upstream credentials, daily sending limits, sender identities, and verify connectivity

Server Name *

Provider Type *

Sender Email (From) *

Sender Name (From Name)

Custom Reply-To Email

Provider API Key *

Enter your upstream provider API key. For Resend, this starts with re_.

SMTP Host

SMTP Port

SMTP Username

SMTP Password

Use SSL/TLS (Port 465)

Daily Sending Limit (emails/24h)

Server Status

Enable this mail server for dispatches

Verify Connection & Credentials

Send an instant test verification email through this server configuration to test authentication and domain delivery.

Bulk CSV Mail Campaign

Upload recipient CSV, map dynamic columns, set dispatch throttle, and launch mass delivery

1. Audience CSV File

Drop CSV file here, or click to browse

Accepts CSV with headers (e.g. email, name, company)

Email Column

Name Column

Throttle Delay

Insert tag:

2. Campaign Content & Routing

Mail Server

Custom Reply-To (Optional)

Load from Template

Email Subject Line

HTML Content

Campaign Attachments (Sent to all recipients) Attach Files

Attach brochures, PDFs, or flyers sent to each recipient in this campaign.

Concurrency:

Background queue

Campaign Dispatch Telemetry

Real-time status tracking for every recipient and upstream mail server

Sent:

Failed:

Total:

To (Recipient) & Subject Dispatched Via (Mail Server) Status Time

Quick Send (Single Dispatch)

Test transactional dispatch instantly through any connected mail server

Mail Server

Load Template

Recipient Email *

Recipient Name

Custom Reply-To

Subject *

HTML Body

File Attachments Attach Files

PDF, images, documents, or archives. Base64 encoded automatically.

Enqueue via background queue

Email Templates

Create, preview, and maintain reusable HTML email templates with dynamic tags

Subject:

Insert Tags:

Sample Data for Live Preview

name

company

code

Live Rendering Sandbox

Dispatch Test Email

Send this template immediately to your inbox with interpolated test variables.

Recipient Email

Spam Grader & Deliverability Checklist

Inspect email copy against classic spam filter heuristics and view DNS warmup checklist

Subject Line

Email Body Content

Spam Score Gauge

Triggers Detected:

Analyzes ALL CAPS, trigger keywords, exclamation marks, and unsubscribe links.

Domain Authentication Checklist

SPF Record

Authorize Mailman IPs to send on behalf of your domain:

v=spf1 include:_spf.mailman.cloudrails.in ~all

DKIM Signing

Configure 2048-bit cryptographic key from your upstream provider:

mail._domainkey.yourdomain.com

DMARC Policy

Instruct mailbox providers how to handle unauthenticated mail:

v=DMARC1; p=quarantine; pct=100;

Background Mail Queue

Asynchronous delivery queue with exponential backoff retries and worker monitoring

Pending

Processing

Completed

Failed

Workers

Recipient Subject Status Attempts Actions

Dispatched Telemetry Logs

Audit log of emails dispatched via developer API keys or console workspace

Recipient Subject Dispatched Via (Mail Server) Status Timestamp

Email Tracking & Analytics

Real-time open rates, click-through rates, and tracking events

Total Dispatched

Total Opens

Total Clicks

Open Rate