Managing Contact Lists

Managing contacts is an integral part of your marketing campaigns lifecycle. You can create lists for contacts, as well as view and edit each individual contact within your contact database.

Viewing a contact

To view a specific contact profile, find the contact in one of your lists or segments by searching your contact database. Then, click the contact’s email address. You will then be able to view the email, engagement data, profile information, custom fields, and list associations for this contact.

Searches are case agnostic but must be done using a whole email address that includes an "@" and any top-level domain like ".com" or ".io".

To view any custom fields you have assigned to this contact, or to view any lists that you have added this contact to, you may flip through the tabs beneath the Contact Details. You may either view all custom fields at once, or you can filter them by the following types: “Text”, “Date”, and “Number”.

Editing a contact

When you are viewing a contact, click any of the Edit buttons to edit the contact's information within that section. This includes the SendGrid provided reserved fields, except email, any custom fields you’ve added for this contact, and any lists the contact is associated with.

To edit the associated lists for your contact:

  1. Select the Associated Lists tab.
  2. Enter or select the list you would like to use.
  3. Click Add.

Managing your list

Sending to a well-managed address list can drastically improve your delivery. We have put together some simple steps and guidelines that will improve any senders list.

Identifying Suppressions

In your SendGrid Account are different Suppressions lists.

Global Unsubscribes - Addresses on this list are opted out of all mail.

Bounces - Addresses that have failed to deliver to the recipient's inbox. Once an address has been added to this list, we do not attempt to deliver further messages to it. We will instead Drop them to protect your external reputation.

Spam Reports - Addresses that have marked your mail as spam.

Blocks - Addresses that have blocked your mail temporarily, usually due to factors like a blacklisted IP address. You can attempt to resend to these addresses.

Invalid - Addresses on this list are malformed and do not have a valid email address structure. (Ex., info@sendgridcom, info @

Emails sent to addresses listed in the Bounce, invalid, Spam, and Unsubscribe list are automatically dropped by SendGrid. Feel free to remove these addresses from your lists to save money and time.

Delete unusable contacts

It is common to have contacts that result in a group unsubscribe, block, bounce, invalid email address, or spam report. Attempting to send email to these contacts can negatively impact your reputation since these contacts do not want to (and will not) receive your marketing emails.

To remove all of your unusable Marketing Campaigns contacts:

  1. When viewing your dashboard, navigate to the left-hand menu and click Suppressions.
  2. Open a specific group, such as Bounces or Spam Reports, click the action menu in the upper right corner, then select Download as CSV.
  3. Repeat step 2 for each of the groups that you want to remove (unsubscribes, spam reports, etc.) and merge each of those lists into a single CSV file.
  4. Return to your dashboard, navigate to the left-hand menu and select Marketing, then Contacts.
  5. In the upper right corner click Add Contacts and select Upload CSV.
  6. Select Create New List and name it something obvious, like "Remove Invalid Emails."
  7. Once uploaded, click the action menu to the right of that new list and select Delete.
  8. Check the box indicating to delete "all contacts associated with this list."

Delete a specific contact

There are two methods to delete contacts; one in which only a specific list or segment will be deleted and the contacts will *remain* in All Contacts, and the second in which you can delete a list or segment and ALL associated contacts.
*To remove a list or segment, but keep the contacts in All Contacts:* 1. Navigate to your list or segment. 2. Click the checkbox to the left of your list or segment. 3. Click # selected dropdown and delete. *To remove a list or segment, and ALL associated contacts:* 1. Navigate to your list or segment. 2. Hover over the Action menu to the right of the list or segment. 3. Click on the trash icon. 4. Check the box "Delete all contacts associated with this list from my account." 5. Select delete.

To remove one or more contacts from a list:

  1. Navigate to the All Contacts list.
  2. Search for the contact you want to delete.
  3. Click delete to remove the contact permanently.

Use this to permanently delete your recipients from all of your contact lists and all segments if required by applicable law.

Delete all contacts

To delete all of your contacts at once:

  1. Navigate to your Contacts page and hover over the Action Menu next to All Contacts.
  2. Click the trash can icon.
  3. Select the check box to confirm that you want to delete all contacts and then click Delete.

Additional Resources

See a mistake? Edit this page