Email API Blog - CloudMailin

Header Image CloudMailin's Hosted MCP Server: Email for AI Agents, Without the API Keys

mcp Featured

Hosted MCP Server for AI Agents

Our MCP server is now hosted at mcp.cloudmailin.com. Connect Claude, Cursor, VS Code, or any MCP client to your CloudMailin account with OAuth 2.1 and PKCE: no API keys in config files, separate read and send scopes, and grants you can revoke at any time.

Steve Smith

14 Jul 2026

Changelog

Fixed: Content-Type on full message storage (RAW format)

We've fixed an issue where the Content-Type set on full message storage (RAW format) objects was inconsistent — it varied depending on the structure of each email (multipart/mixed, multipart/alternative, text/plain, and so on).

CloudMailin Team 11 Jul 2026

gmail

Extracting Emails from Gmail with Takeout

Sometimes you need to pull email history out of Gmail and into another system, for archive, accounting, migration, or feeding an LLM's search index. Google Takeout exports your mail as an mbox file. In this article we'll cover what mbox is, how it works, the gotchas that bite mid-export, and how to bridge that historical archive to a webhook destination.

Steve Smith

7 Jul 2026

soc 2

Our first SOC 2 report

We've completed our first SOC 2 Type 2 examination. Here's what that means, why a Type 2 report is the one that matters, and how you can get a copy.

Steve Smith

2 Jun 2026

Changelog

A fresh new look for CloudMailin

We've started rolling out a refreshed design for CloudMailin. The new look lands first across our public site and sign-up flow, with the rest of the dashboard following over the coming weeks.

Steve Smith 29 May 2026

Changelog

New: Markdown support for outbound email

You can now send outbound email using Markdown. Set the markdown parameter when sending via the API and we'll render it to both HTML and a simplified plain text version for you.

Steve Smith 4 Mar 2026

Changelog

Outbound pipeline performance improvements

We're making a number of performance improvements to the outbound email pipeline. We'll share more details as we roll out further improvements.

CloudMailin Team 4 Mar 2026

Changelog

Automatic brand colours for outbound email templates

When setting up an outbound email template you can now enter your website URL and we'll automatically extract your brand colours and logo. These are then applied to your email template so your transactional emails match your brand out of the box.

Steve Smith 26 Feb 2026

Changelog

Updated inbound and outbound API documentation

We've updated our inbound and outbound API documentation to use the live API description. This ensures that our docs are always up to date with the latest endpoints, parameters and response formats.

CloudMailin Team 20 Feb 2026

Changelog

Attachment URLs in full email JSON

Many of our users offload inbound email processing to serverless functions like AWS Lambda, Google Cloud Functions or Azure Functions using our cloud storage providers to store the full message.

CloudMailin Team 11 Feb 2026

dmarc

DMARC Authentication Guide

When a spammer sends email pretending to be from your domain, it damages your reputation and puts your customers at risk. Even though you never sent the message, recipients associate the phishing attack with your brand. These spoofing attacks cost businesses millions annually in lost revenue, damaged relationships, and eroded customer trust.

CloudMailin Team

6 Feb 2026

Changelog

New: Outbound Messages API

In a previous update we started returning UUIDs in the inbound SMTP response. Inbound messages now include this UUID in the API response too, making it easier to correlate messages across your systems.

CloudMailin Team 5 Feb 2026

Changelog

Inbound SMTP now responds with UUID

CloudMailin's inbound SMTP servers now respond with a UUID instead of an integer when accepting email. For example, the response will now be:

CloudMailin Team 1 Dec 2025

email

Curious Windows-1258 Encoding Errors

We initially dismissed the bug reports. A handful of customers were seeing client_error responses when forwarding emails through CloudMailin—the telltale sign of an email encoding error that asks customers to contact support. The emails were marked as Windows-1258, the Vietnamese code page, but customers told us they didn't have any Vietnamese users. The volume was tiny, so we set it aside.

Steve Smith

26 Nov 2025

Changelog

Failed email deliveries now visible in dashboard

You can now see when email deliveries fail and view the associated error messages directly in your dashboard. Previously these errors were only visible in the SMTP / API responses.

CloudMailin Team 20 Sep 2025

claude

CloudMailin MCP - Let AI interact with your CloudMailin Email Address

MCPs are an interesting new development in the world of AI and Large Language Models (LLMs). MCPs give you an API to make calls from your LLM to an external service. The CloudMailin MCP allows you to interact with your CloudMailin email address from your LLM.

Steve Smith

22 May 2025

email

Receiving email attachments in S3 compatible storage

CloudMailin can now send email attachments directly to Amazon AWS S3 compatible stores such as Digital Ocean Spaces, Cloudflare R2, Wasabi, MinIO and more.

CloudMailin Team

19 Mar 2025

Changelog

Set the format for Heroku Addresses

We've added a new option to the Heroku addon to allow you to set the format for the address as you provision it.

CloudMailin Team 21 Feb 2025

Changelog

Test Mode for SMTP

We've extended the test_mode feature for outbound SMTP to allow you to test your outbound SMTP configuration without actually sending the email.

CloudMailin Team 5 Nov 2024

Changelog

Send email attachments to AWS S3, Azure or Google Storage

Today we're excited to announce that all storage providers are now available for both attachments and full message storage.

CloudMailin Team 25 Sep 2024

email

Announcing Email Layouts (Beta)

Unlock the full potential of your transactional email campaigns with CloudMailin's responsive layouts (Beta). Our best practice email designs allow you to get started sending professional, well-designed, and mobile-friendly emails effortlessly.

CloudMailin Team

20 Sep 2024

Changelog

DMARC Report Alpha

We're excited to announce that we're launching an alpha of our DMARC analytics service. DMARC Reports let ISPs report back on who is sending email on your behalf. This can help you identify any unauthorized senders and improve your email deliverability.

CloudMailin Team 4 Jun 2024

Changelog

Absolute email status times

Our latest dashboard has been released using UTC time as the default for all inbound and outbound email statuses. This makes it easier to find details of historic email events. However, should you wish to change back to the relative time you can simply click the clock icon to switch.

CloudMailin Team 28 May 2024

Changelog

Realtime updates for dashboard

Our latest dashboard has been released with a new real-time update for emails sent and received. Working with CloudMailin to send emails should be easier than ever.

CloudMailin Team 28 May 2024

Changelog

Set DKIM Records with a CNAME (Beta)

CloudMailin has used 2048 bit keys for DKIM records for some time now as we're committed to providing the best security for our customers. However, the process of adding these records to your DNS can be a little tricky.

CloudMailin Team 22 Apr 2024

Header Image What is a transactional email a 2024 review?

reputation

What is transactional email?

What is transactional email and does it compare to other types of email? Next we'll discuss maximising email deliverability and what makes the best transactional email platform.

CloudMailin Team

30 Mar 2024

Changelog

Fixed: email attachment encoding with text/* content type

We've fixed a small issue where attachments with a text/* content type were being encoded incorrectly. This was causing some characters to be displayed incorrectly once stored.

CloudMailin Team 28 Mar 2024

Changelog

New: email attachments via the API

It's now possible to set attachments via the API when creating a new address. Please see the API documentation for more detials.

CloudMailin Team 20 Mar 2024

Changelog

New: deliverability tests check DMARC, DKIM, SPF

We've added a tool to let customers check deliverability of their emails. You can check any sent email for DMARC, DKIM and SPF records that are correctly setup just by sending to a CloudMailin address.

CloudMailin Team 8 Feb 2024

python

Receive email with Python and Django in 2023

CloudMailin allows you to receive any volume of email from within your website or application. Although we've had example code showing receiving email with Python for some time the examples needed a refresh to bring them up to date. We've just updated our just updated our documentation to include examples of receiving email in Python with Flask and Django.

Steve Smith

25 Sep 2023

Changelog

See received email attachment details in the dashboard

We've added a new feature to the dashboard that lets you see details of attachments received with inbound emails. This is useful for debugging and understanding the content of emails that are sent to your CloudMailin address.

CloudMailin Team 21 Sep 2023

email

New email previews for sent email

We are excited to announce that CloudMailin now allows you to preview sent email messages whether they were sent via SMTP or our Email API.

CloudMailin Team

1 Sep 2023

Changelog

New: added outbound email message previews

It's now possible to see previews of outbound emails that have been sent. A blog post with more details is coming soon.

CloudMailin Team 20 Aug 2023

nextjs

Receive email with Next.js

Next.js is a React framework that allows you to build static and server-side rendered applications. In this article, we'll explore how to send and receive email using CloudMailin and Next.js's API routes written in Typescript.

Steve Smith

4 Aug 2023

supabase

Receive email with supabase

Supabase is an open-source database, authentication system, and hosting platform that allows developers to quickly and easily build powerful web-based applications. It provides an API that enables developers to connect, query, and manage data on their web projects and mobile applications.

Steve Smith

12 May 2023

teams

Now your team can manage your Email API

For over 12 years CloudMailin has provided our customers with the ability to receive email via API as a webhook. In recent years we've also added an outbound email API that allows customers to send transactional email via HTTPS (or send messages via SMTP), making inbox delivery clear and simple.

CloudMailin Team

16 Nov 2022

golang

Sending and Receiving email in Go

There are multiple ways to send and receive email with Go (Golang). In this article we'll take a look at a couple of them and why we think using HTTP is actually a great method vs SMTP, IMAP and POP3.

CloudMailin Team

12 Apr 2022

Header Image What is a webhook and how does email to webhook work?

webhooks

What are email webhooks?

In this article we discuss webhooks, what they are and how you can use webhooks for both email to webhook and sending email events.

CloudMailin Team

24 Jan 2022

aws

Full Email Storage / Backup API

CloudMailin allows you to store or backup an entire email in either EML format or fully parsed JSON. Full Emails are stored within an AWS S3 bucket, Azure Blob Storage or Google Cloud Storage and delivered to your webhook, creating an encrypted backup with API for your web application.

CloudMailin Team

16 Nov 2021

smtp

Which SMTP port should I use for sending email?

Learn the difference between the main SMTP client and server ports (Port 25, 465, 587 and 2525), which one you should choose, what Start TLS is, and why you shouldn't use port 25 to send email messages.

CloudMailin Team

15 Oct 2021

Header Image Receiving Email Attachments in AWS S3 is changing

aws

HTTPS Links for S3 Attachments

CloudMailin allows you to receive email attachments directly to Cloud Storage such as AWS S3. Starting Oct 15 2021 these links will use HTTPS.

CloudMailin Team

1 Oct 2021

Header Image Using TypeScript with AWS Lambda and SAM

aws

TypeScript and AWS Lambda?

In this article, we'll discuss how to get TypeScript working with AWS Lambda and AWS SAM in just a few easy steps.

Steve Smith

27 Aug 2021

Header Image What is AWS SAM? Building an HTTP API with Amazon Web Services Serverless Application Model and Lambda

aws

Building an HTTP API with AWS SAM and Lambda

In this article, we cover what AWS SAM is, how to get started and how it helps deploy serverless applications and Lambda functions to Amazon Web Services. We'll use JavaScript here, but AWS supports a range of languages.

Steve Smith

12 Aug 2021

node

Sending and Receiving email in Node.js

In this article, we'll cover a couple of ways to send email in Node.js and TypeScript. Following this we'll outline a quick and easy way to receive email with CloudMailin.

CloudMailin Team

12 Mar 2021

google

Email attachments with Google Cloud Storage

CloudMailin can parse the attachments from email and send the email attachment to Google Cloud Storage automatically.

CloudMailin Team

29 Dec 2020

Header Image Using Basic Authentication with AWS API Gateway and Lambda

aws

Basic Auth with AWS API Gateway & Lambda

Basic authentication is one of the oldest and simplest ways to authenticate HTTP Traffic. Although it has been superseded by a range of different options it's still one of the easiest and most convenient methods, as long as you're using HTTPS.

CloudMailin Team

3 Nov 2020

azure

Email attachments with Azure

CloudMailin allows you to receive emails via an HTTP POST, essentially sending email to a webhook.

CloudMailin Team

10 Jul 2020

Header Image Upgrading the TLS minumum version to TLSv1.2

deprecate

Email encryption upgrade

Security has always been a priority for us at CloudMailin. As an email service provider it's often necessary for us to balance customer requirements and usability and where possible we always give our users a choice. For a while now we've supported both TLS 1.2 and TLS 1.3 on our platform, but we've also allowed connections from servers using TLS versions lower than this if the customer requests it.

CloudMailin Team

1 Jul 2020

Header Image Deprecating our original format

deprecate

Deprecating the original format

When we first started over 10 years ago our original HTTP Webhook format was our only option. The original HTTP Format was a multipart/form-data format that was opinionated, it made a lot of decisions about how you might use it.

CloudMailin Team

21 May 2020

dkim

What is DMARC?

Looking for a comprehensive implementation guide? This post provides a quick DMARC reference. For an in-depth guide covering setup, policy progression, report analysis, and best practices for 2026, see Email Authentication with DMARC: A Complete Guide for 2026.

CloudMailin Team

20 May 2020

dkim

What are DKIM and SPF?

Sender Policy Framework (SPF) and DomainKeys Identifier Mail (DKIM) are both methods of identifying email senders.

CloudMailin Team

4 May 2020

reputation

Understanding Email Reputation

Email sender reputation is crucial when sending an email. Since the early 1990s people have been sending Unsolicited Bulk Email or SPAM and it's critical you understand how to check and manage your reputation.

CloudMailin Team

17 Apr 2020

Header Image Automatically uploading email attachments to Amazon S3

aws

Email attachments with AWS S3

For a while now CloudMailin has allowed you to send your attachments to S3. We call this feature attachment stores, but what exactly does this mean?

CloudMailin Team

1 Mar 2020

Guides, updates, and deep dives on email infrastructure.

Hosted MCP Server for AI Agents

Fixed: Content-Type on full message storage (RAW format)

Extracting Emails from Gmail with Takeout

Our first SOC 2 report

A fresh new look for CloudMailin

New: Markdown support for outbound email

Outbound pipeline performance improvements

Automatic brand colours for outbound email templates

Updated inbound and outbound API documentation

Attachment URLs in full email JSON

DMARC Authentication Guide

New: Outbound Messages API

Inbound SMTP now responds with UUID

Curious Windows-1258 Encoding Errors

Failed email deliveries now visible in dashboard

CloudMailin MCP - Let AI interact with your CloudMailin Email Address

Receiving email attachments in S3 compatible storage

Set the format for Heroku Addresses

Test Mode for SMTP

Send email attachments to AWS S3, Azure or Google Storage

Announcing Email Layouts (Beta)

DMARC Report Alpha

Absolute email status times

Realtime updates for dashboard

Set DKIM Records with a CNAME (Beta)

What is transactional email?

Fixed: email attachment encoding with text/* content type

New: email attachments via the API

New: deliverability tests check DMARC, DKIM, SPF

Receive email with Python and Django in 2023

See received email attachment details in the dashboard

New email previews for sent email

New: added outbound email message previews

Receive email with Next.js

Receive email with supabase

Now your team can manage your Email API

Sending and Receiving email in Go

What are email webhooks?

Full Email Storage / Backup API

Which SMTP port should I use for sending email?

HTTPS Links for S3 Attachments

TypeScript and AWS Lambda?

Building an HTTP API with AWS SAM and Lambda

Sending and Receiving email in Node.js

Email attachments with Google Cloud Storage

Basic Auth with AWS API Gateway & Lambda

Email attachments with Azure

Email encryption upgrade

Deprecating the original format

What is DMARC?

What are DKIM and SPF?

Understanding Email Reputation

Email attachments with AWS S3