Mailosaur Create Server
Create a new Mailosaur server (virtual inbox). Returns the new server with its ID. Send test emails to any-address@SERVER_ID.mailosaur.net to capture them.
Mailosaur Delete All Msgs
Permanently delete ALL messages and attachments in a server. Useful for cleaning up between test runs. This cannot be undone.
Mailosaur Delete Message
Permanently delete a single message and its attachments. This cannot be undone.
Mailosaur Delete Server
Permanently delete a Mailosaur server and all its messages and attachments. This cannot be undone.
Mailosaur Forward Message
Forward an email message to a verified external email address. You must provide at least one of 'html' or 'text' as the forwarding body. Optionally override the subject. Returns the full forwarded message.
Mailosaur Generate Otp
Generate a one-time password (OTP/TOTP) from a base32-encoded shared secret. Use this to automate 2FA verification flows in tests. Returns the current 6-digit code and its expiry time.
Mailosaur Get Deliverability
Run a deliverability analysis on a received message. Returns SPF, DKIM, DMARC results, blocklist checks, content flags, DNS records, and a SpamAssassin score with rule breakdown.
Mailosaur Get Email Source
Download the raw EML source of an email message. Returns the full RFC 5322 email source including all MIME headers, which is useful for debugging deliverability, encoding, and header issues.
Mailosaur Get Messages
Get Mailosaur messages. Pass message_id for full message details (HTML body, text body, links, images, attachments, SMTP headers). Omit message_id to list message summaries for a server — 'server' is required when listing. Get server IDs from get_servers. To filter by sender/subject/body, use search_messages instead.
Mailosaur Get Server Pwd
Retrieve the SMTP/POP3 password for a server. Use this password with the server ID as username to configure applications that send email via SMTP (host: mailosaur.com, port: 25/587/465).
Mailosaur Get Servers
Get Mailosaur servers (virtual inboxes). Pass server_id to retrieve a single server, or omit to list all servers with their IDs, names, and message counts. Use a server ID from this response when calling get_messages, search_messages, or send_email.
Mailosaur Get Usage Limits
Retrieve current Mailosaur account usage limits and consumption. Shows limits and current usage for servers, users, email, SMS, previews, and phone numbers.
Mailosaur Get Usage Txns
Retrieve the last 31 days of usage transactions. Shows daily counts of emails received, emails sent, SMS, previews, and screenshots.
Mailosaur Reply To Message
Reply to an email message. The original message must have been received from an external sender (not created via send_email with send=false). You must provide at least one of 'html' or 'text' as the reply body. Returns the full reply message.
Mailosaur Search Messages
Search for messages matching criteria within a Mailosaur server. Filter by sender, recipient, subject, or body text. Returns message summaries — use get_messages with message_id for full content including HTML body and links.
Mailosaur Send Email
Send an email from a Mailosaur server. The recipient must be a verified external email address in your Mailosaur account. Set 'send' to false to create the message without actually delivering it.
Mailosaur Update Server
Update a Mailosaur server (rename an inbox). Returns the updated server.
