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 -
  • 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".

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.