How to Configure SendGrid SMTP in WordPress
Step-by-step tutorial to configure SendGrid SMTP for reliable WordPress transactional emails.
Quick Overview: The Short Answer
Create a SendGrid API Key with Mail Send permissions, configure your SMTP host to smtp.sendgrid.net on port 587 with TLS, and verify sending with a test email.
Prerequisites & Tools Needed
Ensure you have the following accounts, permissions, and tools ready before beginning:
Requirements & Permissions
- Verified SendGrid Account with Single Sender Authentication Required
- WordPress Administrator Access Required
Tools & Materials
Step-by-Step Instructions (3 Steps)
Follow these verified, sequential instructions to complete the process:
- 1
Generate a Restricted SendGrid API Key
Log in to your SendGrid dashboard. Navigate to Settings > API Keys and click Create API Key. Select Restricted Access and grant Full Access exclusively to Mail Send.
Pro Tip: Never grant Full Access to the entire account if this key is only used for sending transactional emails.Caution: Copy the API key immediately upon generation. SendGrid will never display it again. - 2
Configure SMTP Settings in WordPress
In WordPress, open your SMTP settings. Set the SMTP Host to smtp.sendgrid.net, Encryption to TLS, Port to 587, and enter apikey as the username with your secret key as the password.
Pro Tip: Ensure your From Email matches the verified sender address in SendGrid exactly. - 3
Send a Test Email and Verify Delivery
Use the built-in email test tool to dispatch a test email to your inbox. Check the SendGrid Activity Feed to confirm the 250 OK delivery receipt.
Pro Tips & Best Practices
Expert optimizations and advice to help you avoid future friction and streamline your workflow:
Set Up Domain Authentication (SPF & DKIM)
Configuring CNAME DNS records for your domain significantly improves inbox placement and removes the via sendgrid.net header.
Troubleshooting Common Issues
If you encounter unexpected errors or unexpected behavior during setup, here is how to resolve them:
535 Authentication Failed Error
Change the SMTP username to the literal word apikey and paste your API key as the password.
Summary & Next Steps
Step-by-step tutorial for configuring SendGrid SMTP in WordPress with verified API keys and DNS authentication.
