Troubleshooting the SendGrid SMTP Integration

2 min read

Normally, our SendGrid integration works right out of the box once it’s toggled on for the site you wish to use it on. On occasion though, we do get reports of this not working immediately.

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

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, they you’re 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 email 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.

Next try authenticating the domains you’re trying to send mail from. This is a good idea anyway to ensure ongoing delivery, but as of April 2020, we’ve had multiple of reports of this immediately fixing emails not sending. It’s very possible that SendGrid may be 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/

Hopefully, at this point you’re 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/