Adding domains/emails to the Allow list

Objective

This article provides a step-by-step guide on how to add emails or domains to the SendGrid Address Allow List. This is essential for ensuring that specific emails or domains are not blocked despite being in any Suppression list, allowing them to bypass them and be delivered.

 

Product

Twilio SendGrid (Email)

 

User Account Permission/Role(s) Required 

Primary Administrator or Teammate with full Mail Settings > Address Allow list permission

 

Procedure 

From the UI

1. Access your SendGrid account by logging in with your credentials.
2. Go to the "Settings" tab in the left-hand men and click on "Mail Settings."
3. Under Mail Settings, find and click on "Suppression Settings."
4. Click on "Address Allow List." Here, you can add individual email addresses or entire domains that you wish to allow.
5. Enter the email addresses or domains you want to add to the allow list.
6. Click "Save" to update the list.

Via API

1. Prepare API Request:

• Use the SendGrid API to manage your Allow List. Full documentation available here.
• The endpoint for managing the Allow List is /v3/mail_settings/address_whitelist.

2. Create a PATCH Request:

• Construct a PATCH request to update the Allow List.
• Ensure the payload includes the full list of emails/domains you want to allow. Example payload:

  {
  "enabled": true,
  "list": ["example1@example.com", "example2@example.com", "example.com"]
  }

3. Send the Request:

• Use a tool like Postman or a script in your preferred programming language to send the PATCH request to the API endpoint.

4. Verify Changes:

• Check the response to ensure the request was successful.
• Verify the changes in the SendGrid UI under the Address Allow List.

Additional Information 

• Overwriting the List: When using the API, each PATCH request must include the entire list of allowed emails/domains. If the list is empty, it will clear the Allow List.
• No Bulk Delete: There is no feature to bulk delete entries from the Allow List. Each entry must be managed individually.
• Access Control: Ensure that only authorized personnel have access to modify the Allow List to prevent accidental deletions or changes. (Email)