Mail Settings

Mail Settings allow you to tell SendGrid specific things to do to every email that you send to your recipients over SendGrid’s Web API or SMTP Relay.

Address Allow List

The Address Allow List setting allows a specified email address or domain for which mail should never be suppressed. For example, you own the domain “example.com,” and one or more of your recipients use email@example.com addresses, by placing example.com in the Address Allow List setting, all bounces, blocks, and unsubscribes logged for that domain will be ignored and sent as if under normal sending conditions.

Settings

  • Status - On or Off

  • Emails/Domains - Either a single email or the domain, for which all emails belonging to this domain will be allowed.

BCC

Due to low usage, this setting has been removed. Click here for more information.

Automatically sends a blind carbon copy (BCC) to an address for every email sent without adding that address to the header. Please note that only one email address may be entered in this field, if you wish to distribute BCCs to multiple addresses you will need to create a distribution group or use forwarding rules.

With this setting turned on, you will be charged an extra email for every email you send.

Settings

  • Status - On or Off

  • Email to BCC To - Click Edit to add an email address to which all emails you send will be BCCd.

Bounce Purge

Allows you to set a schedule for SendGrid to automatically delete contacts from your soft and hard bounce suppression lists.

Settings

  • Status - On or Off

  • Soft Bounces - The number of days soft bounces will be kept in your soft bounces suppression list. Any soft bounces older than this value will be purged (Min: 1, Max: 3650).

  • Hard Bounces - The number of days hard bounces will be kept in your hard bounces suppression list. Any hard bounces older than this value will be purged (Min: 1, Max: 3650).

Please Note: Entering values for both Soft and Hard Bounces is not necessary. Only enter a value for the types of bounces you would like purged; empty values will be ignored.

Event Notification

The Event Notification setting controls webhook notifications for events, such as bounces, clicks, opens, and more. This setting allows these events to be POSTed to a URL of your choosing.

Please see our technical Event Webhook API docs for more information about Event Webhook.

Settings

  • Status - On or Off

  • HTTP Post URL - The URL you would like us to send all event notifications.

  • Select Actions - Check the boxes for which events you would like sent to your webhook endpoint.

Other features

Test Your Integration - Once you have a valid URL entered, this button will be made active. When you click the button, we will attempt to send a test post to your webhook code. If we see any issues, we will notify you in a warning message at the top of your browser.

Footer

The Footer setting will insert a custom footer at the bottom of the text and HTML bodies. Use the embedded HTML editor and plain text entry fields to create the content of the footers to be inserted into your emails.

This feature is not available in our Marketing Campaign Editor.

Settings

  • Status - On or Off

  • Footer - HTML Body: Click “Edit” to add your custom footer content.

Forward Bounce

Activating this setting allows you to specify an email address to which bounce reports are forwarded. Insert the email address to which you would like to receive these bounce reports.

You will not be charged an email when these reports are forwarded to you.

Forward Bounce Messages mail setting will only forward "Bounce" events. "Block" events will not be included in the forwarding for this setting.

Settings

  • Status - On or Off

  • Email - Click “Edit” to add an email address where you’d like bounce emails to be forwarded.

Forward Spam

Activating this setting allows you to specify an email address to which spam reports are forwarded. Insert the email address to which you would like to receive spam reports.

You will not be charged an email when these reports are forwarded to you.

Forwarding abuse

The email address specified in the Forward Spam mail setting may also be used to receive emails sent to abuse@ and postmaster@ role addresses if you have authenticated your domain.

For example, if you create a valid authenticated domain with a custom return path of sub and a root domain example and have turned on Forward Spam, any emails sent to abuse@sub.example.com or postmaster@sub.example.com will be forwarded to the email address you entered in the Forward Spam mail setting.

Settings

  • Status - On or Off

  • Email - Click “Edit” to add an email address where you’d like spam to be forwarded.

Legacy Email Template

This setting refers to our original Email Templates. We now support more full featured transactional templates, with support for multiple templates, versioning, and more.

This setting wraps an HTML template around your email content. This can be useful for sending out marketing email and/or other HTML formatted messages. Use the embedded, full-featured HTML editor to create a template that your emails will be wrapped in. Be sure to include a tag to place the content of your email.

Settings

  • Status - On or Off

  • Template - Click Edit to define your HTML template within the WYSIWYG editor.

Plain Content

Due to low usage, this setting has been removed. Click here for more information.

The Plain Content setting will automatically convert any plain text emails that you send to HTML before sending (if disabled).

Turn on if you don't want to convert your plain text email to HTML.

Large plain text files are sometimes unable to be converted to HTML. Instead, SendGrid will send only the plain text version. If HTML versions are essential, it is best practice to include the HTML portion of the email within your email requests. When SendGrid is unable to convert from plaintext to HTML, an alert is sent to the From address.

Settings

  • Status - On or Off

Spam Checker

Due to low usage, this setting has been removed. Click here for more information.

The Spam Checker setting, is useful when your web application allows your end users to create content that is then emailed through your SendGrid account. Since emailing user generated content is hard to monitor and can often be abused by spammers, the Spam Checker filter notifies you when emails are detected that exceed a predefined spam threshold.

The default threshold is 5.0 and can range between 1 and 10. The lower the number, the more strict the filtering. For example, a value of 2 will drop all but the most flawless emails, whereas 9 will only drop the spammiest of spam emails.

We use SpamAssassin to process the spam checks for this filter. The default threshold is 5.0, but you can set this to any value between 1 and 10. You must provide a URL, so we will post the message to that URL. If a message is flagged as spam using this filter, it will automatically be dropped by our system and will not be delivered to the recipient.

Settings

  • Status - On or Off

  • Spam Threshold - Click Edit to change the threshold from 1-10 (see the message above)

  • URL To Post Spam Messages To - Click Edit to provide an Inbound Parse URL to send spam messages to, so you can inspect them. If you don't have an Inbound Parse URL, check out Setting Up The Inbound Parse Webhook.

Rate this page:

Need some help?

We all do sometimes. Get help now from the Twilio SendGrid Support Team.

Running into a coding hurdle? Lean on the wisdom of the crowd by browsing the SendGrid tag on Stack Overflow or visiting Twilio's Stack Overflow Collective.

Thank you for your feedback!

Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

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

Thanks for your feedback!

thanks-feedback-gif