Skip to main content
The MailBeast API is a task-shaped REST API: each endpoint maps to a job you actually do - connect a mailbox, launch a campaign, load leads, read replies, discover new leads - not to an internal database table.

Base URL

https://api.mailbeast.ai

Auth

Authorization: Bearer mb_live…

​
Design principles

These principles shape every endpoint as it ships:
  • Composites over ceremony. Create a fully-configured, optionally-live campaign in one call instead of six.
  • One-or-many bodies. Ingest endpoints accept a single object or an array of the same shape.
  • Cursor pagination on every list. Least-privilege scopes on every route.
  • One error envelope everywhere: { "error": { "type", "code", "message", "status", "requestId" } }, plus an optional details[] on validation errors and retryAfter on 429s.

Get started

Create a key and make your first authenticated call in two steps.

Related topics

Workspace analytics roll-up