SendGrid Extension

The SendGrid Extension for Newsletter provides integration with SendGrid SMTP/API and bouncing detection service.

You can get it on downloads page and install it following the instructions on the Newsletter Extension Installation page.

SendGrid provides an mail delivery service you can use to send emails from your Newsletter plugin solving most of the problems caused by provider limitations (black listed servers, strict limits, reliability, …).

From time to time they change the pricing and the plans, so checkout the plan is better for you. Surely they have at least a free trial, it’s a perfect staring point.

Using the API 3 method

This is the recommended setting, other methods will be removed in future versions. Read more below.

Select the API v3 method in this extension panel.

Go to your Sendgrid dashboard to create a API key following the Setting menu and selecting “API key”. They can change without notice the menu and the dashboard organization so you may find this feature moved under another menu.

When you add a new API key they’ll ask the permissions you want to give it. Enable at least the mail sending and the suppression lists management. See the pictures below:


When you save the permissions, you’ll be presented with an API key. COPY IT SUDDENLY since it won’t be shown again.

You API key are then listed in the main API keys panel BUT THEY ARE NOT USABLE to configure the extension, you need the original value shown just after the key creation.

Add the key to the extension configuration and leave empty the other fields (like the username and the password).

Do a connection test BEFORE to enable the extension. Once enabled Newsletter starts to use it so you must be sure it is working.

It is no working

There could be a little problem with old Sendgrid accounts since Sendgrid left the old account in an old platform where the API v3 are NOT SUPPORTED.

So, you should try to use the API v2 if you’re experiencing that problem which works with username and password. Even in the old accounts dashboard there is the API key generation panel as seen above but the key then does not work.

If you are in this situation we strongly recommend to create a new Sendgrid account. We did it for our self as well.

Using the SMTP method

Actually there is no more reason to use the SMTP method, so follow the steps to use the API v3 or API v2.

Anyway if you extension is setup with SMTP (maybe it’s an old setup), the username and password are required to use the SMTP.

The host address is and the protocol can be SSL on port 465.


Once activated, the module overrides the (eventually) configured SMTP on main Newsletter configuration.

Bounces retrieval

If active, the SendGrid extension starts a daily process that checks for bounces connecting to the appropriate SendGrid service.

Bounced email addresses are marked as “bounced” and won’t be contacted anymore.

Note that there are two kind of bounce, soft and hard: this module only checks for hard bounces (permanent error on that mailboxes) while soft bounces (temporary error, for example a full mailbox) are ignored.

Note: since the API v3 are providing other kind of bounces (they are differentiating the hard bounce, spam and so one) we’re updating the interface to get even those kind of bounces.

To install this extension see the Newsletter Extensions Installation page.