Troubleshooting the SendGrid SMTP Integration

3 min read

Previously, our SendGrid integration worked right out of the box once toggled on for the site you wish to use it on. More often than not now though, you will likely need to verify your domain with SendGrid for them to start sending mail from your website.

About our Integration

Our SendGrid integration is fairly simple – we drop in a plugin that contains your API key and then pass it along to SendGrid.

That’s all there is to it, so as long as you don’t have a competing mail system that could potentially interfere, it provides and quick and easy solution to get your website mail up and running.

Below are instructions for troubleshooting ALL of the issues we sometimes see when getting SMTP up and running. 

Domain Authentication

First, try authenticating the domains you’re trying to send mail from. This is always a good idea anyway to ensure ongoing delivery, but as of April 2020, we’ve had multiple reports of this immediately fixing emails not sending. SendGrid and all SMTP providers are clamping down on sending emails from unauthenticated domains.

Here is SendGrid’s knowledgebase article on how to do this: –
https://sendgrid.com/docs/ui/account-and-settings/how-to-set-up-domain-authentication/

Test Your API Key

Below is a simple copy and paste code block you can use to test your SendGrid API key and the domain you’re having issues with:

curl -i --request POST \
--url https://api.sendgrid.com/v3/mail/send \
--header 'Authorization: Bearer {api-key-here}' \
--header 'Content-Type: application/json' \
--data '{"personalizations": [{"to": [{"email": "yourmemail@address.com"}]}],"from": {"email": "do_not_reply@{domain.com}"},"subject": "SendGrid Test!","content": [{"type": "text/plain", "value": "Howdy!"}]}'

Switch out the parts highlight above with your API key, your email address, and the domain you’re trying to send mail from.

Next, simply copy and paste it into any one of your servers. You will be given the exact reason for the failure. For example:

{"errors":[{"message":"The from address does not match a verified Sender Identity. Mail cannot be sent until this error is resolved. Visit https://sendgrid.com/docs/for-developers/sending-email/sender-identity/ to see the Sender Identity requirements","field":"from","help":null}]}

Now you’ll know whether it’s an issue with your API key. If it isn’t and the mail sends successfully, then follow the steps below.

Additional Troubleshooting Steps

If you’ve found your emails aren’t sending, here are a few possible causes: –

  1. Are there any other mailer-type plugins installed? Another SMTP plugin may be interfering with our integration. If there is, please deactivate it and try again to see if this fixes the issue.
  2. Are emails being sent to spam or missing your inbox entirely? Check your SendGrid logs within your SendGrid account. Are the emails showing up? If they are, then your emails may be going to your spam folder, or possibly not even making it that far. For this, you will likely need to authenticate your domain so that email services know that SendGrid is fully authorised to send emails on your behalf.
  3. Your API key isn’t working correctly. Try regenerating a new API key and make sure it has full access.
  4. If you’ve updated your API key, be sure to toggle the integration off and then on again to ensure your new credentials are added to your website.

Hopefully, at this point your mail is now working correctly, but if none of the above gets you going, the next step would be to reach out SendGrid’s support to find out what’s going on from their end. 

https://sendgrid.com/docs/ui/account-and-settings/support/