Rate this page:

Apple Mail

These instructions show how to add an SMTP server to an existing Mail account, but you can also add these settings at the account creation stage.

Adding SMTP settings

Go to Mail -> Preferences (⌘,). On the account you want to edit, click the tab that says Server Settings, then click the Outgoing Mail Account dropdown and select Edit SMTP Server List....

Mail, Preferences, Outgoing Mail Server (SMTP) dropdown, Edit SMTP Server List

Next, click the + under the list of SMTP servers, and add a new one.

The plus button to click to add an SMTP server

Then enter the server details:

  • Description: SendGrid
  • User Name: SendGrid account username
  • Password: SendGrid account password
  • Host Name: smtp.sendgrid.net
  • Uncheck Automatically manage connection settings if you want to specify Custom Ports, Encryption Type and Authentication
  • Port: Specify the port
  • Encryption: Check or uncheck Use TLS/SSL
  • Authentication: Password

Settings for Mail to use SendGrid SMTP

Now the SendGrid SMTP Server can be specified on the Accounts tab of the Preferences window in the Outgoing Mail Account dropdown. Once this is selected, mail sent out of Apple Mail going forward will use the SMTP server chosen until specified otherwise.

The dropdown menu to select the SMTP server to use for this send.

Unfortunately, there is not an easy way to add SMTP API headers to a message in Mail.

Attachment Compatibility

Mail will sometimes attach images in a way that is incompatible with other email readers. However, this behavior can be changed so that Mail will send more traditional non-inline attachments.

  1. Open Terminal (found in Finder > Applications > Utilities).
  2. In Terminal, paste the following: defaults write com.apple.mail DisableInlineAttachmentViewing -bool yes.
  3. Press return.
  4. Restart the Mail app.

If you wish to restore the normal behavior of Mail, repeat the steps above while using the following command: defaults write com.apple.mail DisableInlineAttachmentViewing -bool no.

Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the SendGrid tag on Stack Overflow.


        Thank you for your feedback!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. Please select the reason(s) for your feedback or provide additional information about how we can improve:

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more