Back to General Articles

Using free email SENDGRID for SMTP email via vbulletin forum
by mdawg 01 Oct 2016
Rating: (8 votes - 4.88 average)

I am running vbulletin 5 (currently 5.2.4). I am on a hostgator shared cpanel Linux server.

[Editors Note- The instructions in this article should be the same for all current versions of vBulletin. (VB 3.x, 4.x, and 5.x.)]

The issue I was running into was that the new registration emails and most other emails for my forum members being sent out via vbulletin to all hotmail and outlook recipients, were simply not being received. So new forum registrants were constantly complaining that they were never receiving the activation emails, not even in their spam/junk folders.

Oddly, test emails sent at
Admin CP -> Maintenance -> Diagnostics
WERE getting through to all recipients, including to hotmail and outlook recipients. But the initial new registration (activation) emails, were not getting through.

I determined that this is because hostgator has somehow been blacklisted for hotmail and outlook, and when on a SHARED hostgator server, even using
Admin CP -> Settings -> Options -> Email Settings
and setting it for SMTP and for emails to come straight from your forum (email), STILL all emails were not truly coming from my forum's URL but rather from hostgator mimicking my server. Apparently it is a well know issue that it is almost impossible to send emails to Microsoft owned email addresses (hotmail/outlook/live...) using a shared host or shared email server. They only accept emails from email servers that perfectly match the domain sending them.

I was also having a strange issue which was that emails from my forum sent via SMTP to GMAIL accounts showed as coming from "PayPal" simply because the word "PayPal" is part of my forum homepage title. This was causing problems of its own because people were ignoring and deleting emails marked as coming from "PayPal" because they looked like SPAM.

---

THE SOLUTION I found was to use a free email account from SENDGRID.

I converted to using Sendgrid for smtp (FREE 12K emails per month account) at my forum, and the tests I did show that emails including registration ones came through fine to a hotmail account, and also that emails that came through to gmail came through fine not erroneously marked as coming from "PayPal."

The general way to set up a SENDGRID account at vbulletin is to go to

Settings/options/Email options
and set SMTP Email to YES

then
Change your SMTP username and password to your SendGrid credentials
(You may create new ones
Settings/Credentials
or just use your username and PW that you use to access the sendgrid account)
(You may also create an APIKey and PW
Settings/API Keys
and use these same as username/PW)

Set the server host name to smtp.sendgrid.net

Use ports 25 or 587 for plain/TLS connections and port 465 for SSL connections

A few additional Sendgrid Settings are needed to function best with vbulletin:

At Sendgrid I went ahead and whitelisted the domain.
Settings/Whitelabels/Domains
I used the subdomain name default.myforum.com
After whitelisting it you must go in to your server cpanel and add these CNAME records, and then validate this domain back at Sendgrid.
If you do not whitelist your domain in this way, all emails send out by your forum will appear to come from Sendgrid instead of from email

At Sendgrid I also whitelisted all the email links
Settings/Whitelabels/Email Links
using the subdomain links.myforum.com This is a similar process to the above and avoids Sendgrid sticking its name into the URL links in your emails.

I could not whitelist any IP address because on a free Sendgrid account you don't get this option. But this doesn't seem to be a problem and emails are getting through. (If you get an upgraded Sendgrid account, you will be assigned an IP address, and you may whitelist this through a process similar to that described above for your Domain and Email Links.)

HOWEVER, as far as Email Links, I didn't really like the long long URLs that Sendgrid creates even with the whitelisting, and wanted URLs in my emails to appear simply exactly the way they were created originally, so I went into Sendgrid Tracking
Settings/Tracking/Click Tracking
and inactivated Click Tracking so that the URLs originating from the forum remained intact.

Another Sendgrid setting I had to make Active was in
Settings/Mail Settings/Plain Content
In Mail Settings - "Plain Content" (Convert your plain text emails to HTML) - without this setting made green/active, the test emails sent by the forum at Maintenance/Diagnostics/Email were arriving improperly formatted.

So far, so good. As far as the 12K limit, that's more than enough for my new user registrations, even figuring an average of three emails per registrant (Activation, welcome, and new private message), but then also the system will send out an email for each private message too and for some users for posts made in threads they follow, etc. But I am thinking 12K will be enough.

For those of you on a shared server, especially at hostgator, and for anyone having trouble getting new user registrations through especially to hotmail and outlook, Sendgrid may be the solution. It is working for me.

vblts.ru supports vBulletin®, 2022-2024