Skip to contentSkip to navigationSkip to topbar
Rate this page:
On 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

getting-started page anchor
  1. Navigate to Tools and select Account Settings .
Account settings menu.
  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 )
Account settings guide.

Incorporating SMTP API headers

incorporating-smtp-api-headers page anchor

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 .
Config Editor button.
  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.
Enter mail compose header.
  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".

X-SMTPAPI field.

Rate this page: