MiniMailer API

JSON:API endpoints for MiniMailer. Content negotiation follows JSON:API v1.1: mutation requests must send `Content-Type: application/vnd.api+json` (a `profile` media type parameter is accepted and ignored; an `ext` parameter or any other parameter such as `charset` returns 415, as no JSON:API extensions are supported). Any request whose `Accept` header mentions the JSON:API media type only in instances modified by disallowed parameters — or only with unsupported `ext` extensions — returns 406. This reference is generated from the OpenAPI specification (v1.0.0), so it always matches the live API. General concepts live on their own pages: query parameters, pagination, and errors.

Base URL

https://api.minimailer.app

Authentication

Every request is authenticated with a personal access token sent as a bearer token. Create and revoke tokens from the dashboard, or programmatically through the Tokens endpoints.

Authorization: Bearer $MINIMAILER_API_TOKEN

Media type

The API speaks JSON:API. Send Accept: application/vnd.api+json on every request and Content-Type: application/vnd.api+json on requests with a body.

Resources

Audiences Audience management operations. 5 endpoints Contacts Contact management operations. 6 endpoints Campaigns Campaign management operations. 6 endpoints Domains Sending domain management operations. 6 endpoints O Auth Public OAuth 2.1 endpoints and discovery metadata for MCP clients (apex host, not the api. subdomain). 4 endpoints Inboxes Inbox management operations. 5 endpoints Inbound Emails Inbound email retrieval operations. 3 endpoints Outbound Emails Outbound email delivery operations. 5 endpoints Suppressions Suppression list operations. 2 endpoints Webhooks Webhook management operations. 8 endpoints Tokens Personal access token management operations. 2 endpoints Recipients Recipient privacy and right-to-forget operations. 4 endpoints Compliance Account-level compliance and audit export operations. 1 endpoint