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 Whitelist

The Address Whitelist setting whitelists 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 Whitelist 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 whitelisted.

BCC

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

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.

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, after which SendGrid will purge all contacts from your soft bounces suppression lists.

Hard Bounces - The number of days, after which SendGrid will purge all contacts from your hard bounces suppression lists.

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.

Settings

Status - On or Off

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

Forward Bounce

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

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.

Settings

Status - On or Off

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

Forward Spam

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

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.

Forwarding abuse@ and postmaster@ Emails

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 properly configured your domain whitelabel.

For example, if you create a valid domain whitelabel using the subdomain sub and 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

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

Please note: 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

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.