Rate this page:


To send email using Thunderbird you will have to modify your outgoing server settings in Thunderbird accordingly. Additionally you can modify settings in Thunderbird that will allow you to include an SMTP API header in your emails if you wish to leverage categories or other features of the SMTP API when sending mail via the Thunderbird client.

Getting started

  1. Navigate to Tools and select Account Settings.

  1. Enter the following settings:
  • Description - SendGrid Connection
  • Server Name - smtp.sendgrid.net
  • Port - 465
  • Connection security - SSL/TLS
  • Authentication method - Normal password
  • User Name - apikey
  • Password - Your SendGrid API key. (You can read more about authenticating with an API key at this link)

Incorporating SMTP API headers

To incorporate SMTP API headers:

  1. Select Tools > Options (Win) or Thunderbird > Preferences (Mac) from the menu in Thunderbird.
  2. Click Advanced.
  3. Select General and click Config Editor.

  1. Enter "mail.compose.other.header" under "Filter:"
  2. Double-click mail.compose.other.header.
  3. Enter "X-SMTPAPI"
  4. Click OK.
  5. Close the configuration editor and preferences dialog.

  1. Restart Thunderbird

Create a mail message and just like you would add a CC or BCC to your email, click the drop down option that will now allow you to add a header of the type "X-SMTPAPI" in addition to "To".

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. How could this documentation serve you better?

        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