batch-send-bulk-email

Sends a batch of transactional emails in one Mailtrap API call (default sending stream). Shared fields go on base; per-recipient overrides go in requests[]. Each request must include at least one recipient via to, cc, or bcc. Same inline-vs-template mutual exclusion as send-email — checked after mer

(optional): Array of BCC recipients as { email, name? } objects (bare email strings also accepted at runtime).

(optional): How to break down the stats: aggregated (default), bydomain, bycategory, byemailserviceprovider, or bydate

(optional): Email category for tracking and analytics. Must be omitted when templateuuid is set.

(optional): Array of CC recipients as { email, name? } objects (bare email strings also accepted at runtime).

/ openscount (optional): Filter by click/open count; use with operator: equal, greaterthan, lessthan

/ sendingip (optional): Filter by IP; use with operator: equal, notequal, contain, notcontain

(optional): Default custom variables (string-valued).

(optional): Filter by provider (exact); use with operator: equal, notequal

(optional): Filter by provider response text; use with operator (cicontain, etc.)

(required): End date for the stats range (YYYY-MM-DD)

(optional): Filter by event type(s): delivery, open, click, bounce, spam, unsubscribe, softbounce, reject, suspension; use with eventsoperator (includeevent / notincludeevent)

(optional): Sender as { email, name? } (a bare email string is also accepted at runtime). If not provided, DEFAULTFROMEMAIL is used.

(optional): Filter by sender email; use with fromoperator (default: ciequal)

Gets a single email log message by ID (UUID): a readable summary (from, to, subject, sent time, status, category, stream, engagement, delivery context), then detailed event history. Optionally, with includecontent: true, you can also load and show the message body (HTML and plain text) when Mailtrap

Get email sending statistics (delivery, bounce, open, click, spam rates) for a date range. Optionally break down by domain, category, email service provider, or date. Check delivery rates without leaving the editor.

(optional): Default custom headers.

(conditional): HTML version of the email body. Required (alongside or instead of text) for inline sends; must be omitted when templateuuid is set.

(optional): When true, fetches the raw EML (if rawmessageurl is available) and appends parsed HTML and plain-text body sections, similar to show-sandbox-email-message.

Lists sent email logs (delivery history) with optional pagination and filters. Use to debug delivery issues from the IDE.

(required): UUID of the email log message (from send response or list-email-logs). Use list-email-logs to find message IDs.

(optional): Filter by recipient MX; use with recipientmxoperator (cicontain, etc.)

(optional): Reply-to address.

(required): Non-empty array of per-recipient messages. Each entry has:

(optional): Pagination cursor from the previous response's nextpagecursor

Sends a transactional email through Mailtrap. Supports two mutually exclusive modes — inline content (subject + text/html) or template-based (templateuuid).

(optional): Filter by sending domain ID (number); use with sendingdomainidoperator (default: equal)

(optional): Filter by stream: transactional or bulk; use with sendingstreamoperator (default: equal)

(optional): ISO 8601 date/time; only logs sent after this time

(optional): ISO 8601 date/time; only logs sent before this time

(required): Start date for the stats range (YYYY-MM-DD)

(optional): Filter by delivery status: delivered, notdelivered, enqueued, optedout; use with statusoperator (default: equal)

(conditional): Email subject line. Required for inline sends; must be omitted when templateuuid is set.

(optional): Use a Mailtrap email template instead of inline content. When set, subject / text / html / category must be omitted (per Mailtrap API).

(optional): Object of variables substituted into the template referenced by templateuuid. Only allowed together with templateuuid.

(conditional): Email body text. Required (alongside or instead of html) for inline sends; must be omitted when templateuuid is set.

(optional): Array of recipients as { email, name? } objects (bare email strings, or a single non-array address, are also accepted at runtime). Optional if cc or bcc is provided; at least one of to / cc / bcc must contain a recipient.

(optional): Filter by recipient email; use with tooperator (default: ciequal)