Open-source IoT Platform

Device management, data collection, processing and visualization
for your IoT projects
Learn about Thingsboard

Wednesday, December 21, 2016

Email Plugin Configuration

In this short tutorial we will explain how to configure Email Plugin to distribute alarms to recepients via email. We will use Live Demo Thignsboard server and SendGrid SMTP API in this tutorial. The Email plugin implementation is based on Java Mail and may be easily configured to other mail servers.

SMTP server parameters

Step 1. Get your SendGrid account.

We assume you have SendGrid account. You can sign-up for trial using this link.

Step 2. Configure SMTP Relay

Once logged in open SMTP relay configuration page. Follow instructions on the page to get the API Key. Save the API key somewhere.

Plugin Configuration

Step 3. Login to Live Demo server

Login to Live Demo server using Tenant Administrator account (the one that you created during sign-up).

Step 4. Create new Mail Plugin instance

Open Plugins page and click on big red “+” button. Populate plugin name and description.


Once you choose the corresponding plugin type, the form will expand. Populate values as shown below. Use API key as a password.

NOTE Since demo instance is hosted on Google Cloud, you need to specify 2525 port. All other SMTP related ports are blocked.


Don’t forget to add other mail properties that will force secure connection.


Click on “Add” button.

Step 5. Activate new plugin

Once plugin is saved successfully, don’t forget to activate it by clicking on “Activate” button.


Next Steps

Explore next tutorial to provision basic rules and generate emails based on sensor readings.


Once you configure you plugin and corresponding rules, you may review statistics and events on plugin details page. If you have configured something wrong, you should see errors logged on the corresponding tab:


Your feedback

If you found this article interesting, please leave your feedback in the comments section, post questions or feature requests on the forum and “star” our project on the github in order to stay tuned for new releases and tutorials.


  1. Thanks for this detailed instruction! I’ve stuck with another problem. For a long time I’d been using Live Mail but its functionality cannot be compared with that of Microsoft Outlook, which offers incomparably more in terms of collaboration, integration with corporate environments, control over mailboxes and other aspects of mail exchange. Luckily, I’ve found program that helped me to deal with migrating windows live mail to outlook more info here. It covers all stages of the process, including the location of the source data files, extraction of emails and attachments to a temporary location, file conversion and exporting the data to an Outlook profile. I’ve never worked with email conversion tools but this utility was quite easy to handle.

  2. Friends, I am proud to announce the triumph of my medical essay, fueled by the remarkable example I found at This resource on bipolar disorder's etiology and evidence-based treatment approach guided my research and helped me craft an exceptional essay. Don't miss out on this valuable source of knowledge that can elevate your academic pursuits.

  3. I found this tutorial on how to configure the Email Plugin for Thingsboard to be very helpful. I'm currently working on an IoT product development project and I plan to use this plugin to send alarms to recipients via email. I'm also glad that the tutorial uses the Live Demo Thingsboard server and SendGrid SMTP API. This makes it easy to follow along and test the configuration. I'm sure this tutorial will be helpful to other IoT developers who are looking to configure the Email Plugin for Thingsboard.