Introduction: How to Send Emails With Attachments With Arduino, Esp32 and Esp8266

About: Software developer but I love electronics, wood, nature, and everything else as well.

Here I'd like to explain the version 2 of my library EMailSender, a big evolution respect to version 1, with support for Arduino with w5100, w5200 and w5500 ethernet shield and enc28J60 clone devices, and support for esp32 and esp8266.

Now you can add attachments also, loaded from storage device like SD or SPIFFS. Here Arduino ethernet usage.


  • Arduino Mega
  • enc28J60
  • SD card

Step 1: Select Correct Device ENC28J60 or W5100 Series

Arduino, normally, manage network with external device, the standard device like w5100 use Ethernet library the clones ENC28J60 have some libraries to select.

To select your device you must go on EMailSenderKey.h library file and set the correct one


The library loaded to manage this type of device is UIPEthernet, you can find the library on library manager of the Arduino IDE

or you can change default network type


This is the standard implementation and use Ethernet library.

An important think to consider is that this Ethernet shield not support SSL or TLS, so you must find a provider SMTP that offer an SMTP connection without this type of encription.

I create a topic on forum where you can add the provider you use, that you can find mine also.

Step 2: Send Simple Email

To send an email with Arduino you must find a provider that workwithout SSL or TLS, For my solution I use with the SendGrid provider.

I think the usage is very very simple.

So you must set the provider


Than you must create a message and send It

EMailSender::EMailMessage message;<br>    message.subject = "Soggetto";
    message.message = "Ciao come stai<br>io bene.<br>
    EMailSender::Response resp = emailSend.send("", message);
    Serial.println("Sending status: ");

Step 3: Connect an SD Cart to Manage Attachments

Than to send attachments you must connect an SD card like in the schema, if you need more information about connection refert to this article "How to use SD card with esp8266, esp32 and Arduino".

Step 4: Send Email With Attachments

To send email with attachments you must find a provider that support that functionality, my sendgrid provider not support that and GMX the provider that I used for the test no more support.

But if you find a new provider you can use this code to attach the files.

EMailSender::FileDescriptior fileDescriptor[1];<br>    fileDescriptor[0].filename = F("test.txt");
    fileDescriptor[0].url = F("/test.txt");
    fileDescriptor[0].mime = MIME_TEXT_PLAIN;
    fileDescriptor[0].encode64 = false;
    fileDescriptor[0].storageType = EMailSender::EMAIL_STORAGE_TYPE_SD;
    EMailSender::Attachments attachs = {1, fileDescriptor};
    EMailSender::Response resp = emailSend.send("", message, attachs);

Step 5: The Result

Here the email sended with an esp8266 and GMail provider (to use GMail you must enambe external program).

Step 6: Library

You can find the library on GitHub

And you must ask features or report bugs on Forum

Additional documentation here.

Arduino Contest 2020

Participated in the
Arduino Contest 2020