Documentation
Everything you need to set up, optimize, and get the most out of MailPilot.
Getting started
Four steps to go from signup to a fully monitored sending setup.
Connect your first mailbox
Add a Google Workspace, Microsoft 365, or SMTP account. MailPilot reads authentication headers and begins baseline monitoring immediately.
Run your first warm-up
Set your daily target volume and let MailPilot's AI warm-up engine ramp your domain automatically. Adjust pace from the dashboard.
Read your placement report
See exactly where your emails are landing across Gmail, Outlook, Yahoo, and iCloud. Filter by date, domain, and sending stream.
Feature guides
In-depth walkthroughs for every MailPilot feature.
AI Warm-up Guide
Warm-upHow MailPilot's AI schedules warm-up sends, engages seed accounts, and adjusts pace based on real-time reputation signals.
Inbox Placement Tracking
PlacementUnderstand how placement data is collected, which providers are supported, and how to read trend charts over time.
Reputation Repair Walkthrough
ReputationWhat to do when your sending score drops. Guided repair workflows for authentication failures, blacklist hits, and complaint spikes.
Campaign Setup
CampaignsConnect your sending tool (Instantly, Smartlead, Mailchimp, etc.), map mailboxes to campaigns, and track placement per sequence.
Multi-ESP Configuration
ESPRoute different email types to different ESPs. Configure priority weights, failover rules, and per-ESP monitoring thresholds.
CSV Bulk Import
ImportImport multiple mailboxes at once with the CSV template. Supported fields, validation rules, and common import errors explained.
ESP Priority Weighting
ESPSet percentage splits across ESPs for a given mailbox or campaign. Useful for load balancing and A/B testing sending infrastructure.
API Reference
In developmentA full REST API is currently in development. It will expose all MailPilot resources - mailboxes, placement reports, warm-up sessions, spam scores, and account management - via authenticated endpoints with predictable response shapes.
Authentication uses JWT bearer tokens. Tokens are scoped at the workspace level with optional per-resource read/write permissions. Rate limits, pagination, and error envelope documentation will be published alongside the first stable API release.
REST
Coming
JWT Auth
Coming
JSON
Coming
Versioned
Coming
API preview
GET /api/email-accounts
Authorization: Bearer <token>
200 OK
{
"data": [
{
"id": "acct_abc123",
"email": "you@yourdomain.com",
"provider": "google",
"reputation_score": 94,
"warmup_active": true
}
],
"meta": {
"total": 1,
"page": 1
}
}GET /api/email-accounts/dns-check
Authorization: Bearer <token>
200 OK
{
"results": [...],
"probing": false
}Integrations
Coming soonNative integrations are in development. Here's what's coming first.
Have a question?
The docs are early and we know they're not complete yet. If you're stuck on something, reach out - we respond to every message personally. No ticket queues, no bots.