SendGrid SMTP Settings
Server smtp.sendgrid.net, port 587
with STARTTLS. Full configuration, authentication requirements and
fixes for the errors SendGrid actually returns.
SendGrid is a transactional relay, not a mailbox. The SMTP username is always the literal word apikey; the password is the API key itself. This trips up most first-time integrations.
SendGrid SMTP server settings
Outgoing mail (SMTP)
- SMTP server
- Port
- STARTTLS · Recommended SSL/TLS · Implicit TLS STARTTLS · When 587 is blocked
- Encryption
- STARTTLS
- Authentication
- API key as password
- Username
- The literal string
apikey - Password
- Your SendGrid API key (starts with SG.)
- Sending limit
- Plan dependent — 100/day on the free tier
How to set up SendGrid SMTP
- In the SendGrid dashboard open Settings → API Keys and create a key with Mail Send permission.
- Set the host to
smtp.sendgrid.netand the port to587. - Set the username to exactly
apikey— not your account email. - Paste the API key as the password.
- Verify a sender identity or authenticate your domain before sending.
Verify it before you deploy. Paste these settings into the free SMTP test tool and send yourself a test message. It takes about twenty seconds and tells you whether SendGrid accepted the connection, the encryption and the login — before your application depends on it.
Common SendGrid SMTP errors
| Error | What to do |
|---|---|
535 Authentication failed |
The username must be the literal string apikey. Any other value is rejected. |
550 The from address does not match a verified Sender Identity |
Verify the sender or complete domain authentication in SendGrid. |
Seeing a reply code that isn't listed here? Every standard SMTP response is explained in our SMTP error code reference.
SendGrid SMTP — frequently asked questions
The SendGrid SMTP server is smtp.sendgrid.net. Connect on port 587 using STARTTLS encryption.
Port 587 with STARTTLS (Recommended). Port 465 with SSL/TLS (Implicit TLS). Port 2525 with STARTTLS (When 587 is blocked).
Username: The literal string apikey
Password: Your SendGrid API key (starts with SG.)
The username must be the literal string apikey. Any other value is rejected.
Verify the sender or complete domain authentication in SendGrid.