Skip to content

Securely Uploading Images to Cloudinary by Email With Heroku and Sendgrid

Despite United States founder Benjamin Franklin’s wisdom that three can keep a secret if two of them are dead, you as developers often need contributions from third parties for your project. However, in today’s digital world, security in software development is a predominant concern. With respect to management of rich media, it’d be ideal if those folks could upload images or videos to your Cloudinary account without having to log in.

This post explains how to enable third parties, including project contributors and end-users, to do that by email with free, integrated tools, including SendGrid, Cloudinary’s email server. Actually, that basic function already exists in many electronic devices, from smartphones to smart fridges. Setting it up is a snap.

First, you need an email server but with a twist. As mentioned, we at Cloudinary leverage the one from SendGrid, which accepts any email it receives and then parses it.

Here’s the process flow:

  1. A third party sends an email with an image attachment to the address you configured with your email provider.
  2. For each email, SendGrid creates a webhook and sends it to a Cloudinary app that’s deployed on Heroku.
  3. The app parses the webhook and uploads the image to Cloudinary as an unsigned upload.

Following are the requirements, starting with the final destination, Cloudinary:

Note: Some of the steps generate parameters for the next step. We’ll work on eliminating that complexity.

  • A Cloudinary account. A free one will do just fine. Log in to the dashboard and copy your Cloudinary URL from there for the next step.
  • A platform on which to host your code. Even though you will execute Python code on Heroku, any platform will do. The code repository is on GitHub. You deploy the code with just a button click with no manual efforts whatsoever.
  • An email-service provider. Cloudinary has picked Twilio’s SendGrid as the service provider for receiving and sending emails for uploads to Cloudinary’s Media Library, as described in this post. A free account will do just fine
  • A registered domain. You’ll need to create mail exchange (MX) records to point to the email-service provider.

Refer to the readme on GitHub, which explains how the Cloudinary app cloudinary-email-uploader works with SendGrid’s incoming parser to empower third parties to send email along with images to your Cloudinary account. In addition, you’ll learn how to—

  • Acquire the prerequisite free software.

  • Configure and deploy cloudinary-email-uploader.

The complete code is also on GitHub.

Do give it a try and comment your results below.

Back to top

Featured Post