<commit_before>---
seo:
  title: Mail Settings
  description: Manage your SendGrid mail settings
  keywords: sendgrid mail settings, email settings, sending settings
title: Mail Settings
weight: 0
group: account-management
layout: page
navigation:
  show: true
---

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]({{root_url}}/api-reference/) or [SMTP Relay]({{root_url}}/glossary/smtp-relay/).

## Address Whitelist

The Address Whitelist 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> 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 allowed.

## BCC

<call-out type="warning">

Due to low usage, this setting has been removed. Click [here]({{root_url}}/ui/account-and-settings/retired-mail-settings/) for more information.

</call-out>

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.

<call-out type="warning">

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

</call-out>

**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.

## Bypass

Bypass filters allow you to disregard unsubscribe groups and suppressions to ensure that an email is delivered to all recipients, whether or not they are on a suppression or unsubscribe list. It is important to respect unsubscribes, and these filters should be used only when it is absolutely necessary to deliver a message to recipients who have unsubscribed from your emails.

There are four bypass filters available. Each filter should be sent via the `mail_settings` field as an object with a single boolean field called `"enable"`. When a filter is set to `true`, Twilio SendGrid will disregard or _bypass_ the unsubscribe or suppression status of the addresses in the list, delivering the message to the recipients. All lists not specified by the filter will be checked, and the suppression or unsubscribe status of the addresses in the unspecified lists will be respected. See the [v3 Mail Send API reference](https://sendgrid.api-docs.io/v3.0/mail-send/v3-mail-send) for examples.

- Bypass list management
  - By setting the `bypass_list_management` filter to `true`, your message will bypass all unsubscribes and suppressions in **all** lists. This filter cannot be used in combination with the other bypass filters.
- Bypass spam management
  - By setting the `bypass_spam_management` filter to `true`, your message will bypass the spam report list. All other suppression and unsubscribe lists will be respected.
- Bypass bounce management
  - By setting the `bypass_bounce_management` filter to `true`, your message will bypass the bounce list. All other suppression and unsubscribe lists will be respected.
- Bypass unsubscribe management
  - By setting the `bypass_unsubscribe_management` filter to `true`, your message will bypass the global unsubscribe list. All other suppression and unsubscribe lists will be respected. Note that this bypass filter is applied to global unsubscribes only; group unsubscribes will be respected.

## 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](/API_Reference/Webhooks/event.html) for more information about Event Webhook.

**Settings**

- Status - On or Off<commit_msg>Add example use for bypass filters<commit_after>---
seo:
  title: Mail Settings
  description: Manage your SendGrid mail settings
  keywords: sendgrid mail settings, email settings, sending settings
title: Mail Settings
weight: 0
group: account-management
layout: page
navigation:
  show: true
---

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]({{root_url}}/api-reference/) or [SMTP Relay]({{root_url}}/glossary/smtp-relay/).

## Address Whitelist

The Address Whitelist 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> 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 allowed.

## BCC

<call-out type="warning">

Due to low usage, this setting has been removed. Click [here]({{root_url}}/ui/account-and-settings/retired-mail-settings/) for more information.

</call-out>

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.

<call-out type="warning">

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

</call-out>

**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.

## Bypass

Bypass filters allow you to disregard unsubscribe groups and suppressions to ensure that an email is delivered to all recipients, whether or not they are on a suppression or unsubscribe list. It is important to respect unsubscribes, and these filters should be used only when it is absolutely necessary to deliver a message to recipients who have unsubscribed from your emails. For example, you may use these filters to deliver messages that you are legally required to send to all recipients or important security messages like a password reset.

There are four bypass filters available. Each filter should be sent via the `mail_settings` field as an object with a single boolean field called `"enable"`. When a filter is set to `true`, Twilio SendGrid will disregard or _bypass_ the unsubscribe or suppression status of the addresses in the list, delivering the message to the recipients. All lists not specified by the filter will be checked, and the suppression or unsubscribe status of the addresses in the unspecified lists will be respected. See the [v3 Mail Send API reference](https://sendgrid.api-docs.io/v3.0/mail-send/v3-mail-send) for examples.

- Bypass list management
  - By setting the `bypass_list_management` filter to `true`, your message will bypass all unsubscribes and suppressions in **all** lists. This filter cannot be used in combination with the other bypass filters.
- Bypass spam management
  - By setting the `bypass_spam_management` filter to `true`, your message will bypass the spam report list. All other suppression and unsubscribe lists will be respected.
- Bypass bounce management
  - By setting the `bypass_bounce_management` filter to `true`, your message will bypass the bounce list. All other suppression and unsubscribe lists will be respected.
- Bypass unsubscribe management
  - By setting the `bypass_unsubscribe_management` filter to `true`, your message will bypass the global unsubscribe list. All other suppression and unsubscribe lists will be respected. Note that this bypass filter is applied to global unsubscribes only; group unsubscribes will be respected.

## 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](/API_Reference/Webhooks/event.html) for more information about Event Webhook.

**Settings**

- Status - On or Off
{'fraction_non_alphanumeric': 0.05447223399745655, 'fraction_numerical': 0.00105977108944468, 'mean_word_length': 4.489819662594532, 'pattern_counts': {'":': 0, '<': 13, '<?xml version=': 0, '>': 13, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '923675', 'n_tokens_mistral': 2412, 'n_tokens_neox': 2281, 'n_words': 1358}