MailPilot API

Every endpoint here is the same one MailPilot's own dashboard calls internally - connect mailboxes, start and monitor real warmup traffic, push your own outreach copy through as warmup content so it's pre-trusted before a real campaign, and pull live reputation, inbox-placement, and DNS/authentication data for every mailbox you manage.

Getting an API key

Generate a key from Settings → API Keys in the MailPilot dashboard. Keys look like mp_live_... and are shown in full only once, at creation time.

Authentication

Send your key as a bearer token on every request:

Authorization: Bearer mp_live_xxxxxxxxxxxxxxxxxxxxxxxx

Base URL

https://app.mailpilots.in

Every response is scoped to the mailboxes owned by the account the key belongs to - there is no way to see or modify another user's data.

Rate limiting

Every request counts against a limit of 300 requests per minute, tracked per API key (or per account, if you're calling with a session cookie instead). The window is fixed, not sliding - it resets on the minute.

When you're over the limit, the response is a 429 with the same error envelope as any other error:

HTTP/1.1 429 Too Many Requests
Retry-After: 60
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 0

{ "error": "Too many requests. Please try again later." }

Back off until Retry-After seconds have passed rather than retrying immediately - hitting the endpoint again while still limited just resets your position in the same window. If your integration needs a higher limit, contact usand we'll take a look.

Reference

The sidebar groups every endpoint by area - Mailboxes, Warmup, and Deliverability. Each page includes parameters, request/response schemas, multi-language code samples, and a try-it playground you can run with your own key.