Delete Contacts in Contact Builder
After completing this unit, you’ll be able to:
- Enable Contact Deletion in Marketing Cloud.
- Delete one or more contacts in Contact Builder.
- Review the progress of your deletion requests.
Deleting contact information from Marketing Cloud is an important operation that can dramatically affect your customer data. For this reason, we require that an admin enables the feature before anybody can use it. This section shows you how to turn the feature on.
In this module, we assume you are a Marketing Cloud administrator with the proper permissions to delete contacts. If you’re not an administrator for Marketing Cloud, that’s OK. Read along to learn how your administrator would take the steps in a production org. Don’t try to follow these steps in your Trailhead Playground. Marketing Cloud isn’t available in the Trailhead Playground.
- Log in to your Marketing Cloud account and click Audience Builder in the app switcher.
- Next, click Contact Builder.
- Then click Contacts Configuration.
- Navigate to the Contact Delete section and click Enabled.
- Click Manage Settings.
- The suppression period for Contact Delete defaults to 14 days, but you can set another length value. We recommend setting this value to 0 in the text field to ensure contacts delete almost immediately and you can proceed with your marketing activities.
- Click Save.
There you go! Your account is ready for Contact Delete.
After your account is enabled for Contact Delete, you can remove contact records right in Contact Builder. This section shows you how to delete those contacts, either one at a time or in groups. When you delete contacts from Marketing Cloud, you can select one or more contacts from All Contacts, or you can delete the contact information in your Marketing Cloud account for all contacts in a data extension. Here are the steps you take to delete from All Contacts.
- In Contact Builder, navigate to All Contacts.
- To delete one or more contacts, select the checkboxes next to the appropriate contacts.
- Click and select Delete selected contact.
- Review the deletion information and click Delete.
After you complete this process, you can click and select View Pending Deletions to track the contact deletion progress. You can also check out the information in the Contacts Analytics dashboard, which we cover in the next section.
Contact Delete processes can take some time. If you only delete one contact at a time, it probably won’t take long (depending on what’s going on in your account at the time). But if you’re trying to delete millions of contacts from your account using multiple requests, that could take a little more time. That’s why Marketing Cloud has a dashboard to help you determine how the jobs are progressing.
To view the dashboard, open the Contact Builder app and click Contacts Analytics. All data shown in this dashboard appears in nearly real time.
Here’s what you’ll see.
- Total—shows the sum of all contact delete requests initiated in your account during the specified time period.
- Complete—shows the sum of all contact delete requests made in the specified time period that successfully completed in that same time period.
- Processing—shows the sum of all contact delete requests that have not concluded at this point.
- Invalid—shows the sum of all contact delete requests that contained bad data and did not successfully complete. (Invalid requests result from errors in REST API requests. For example, errors occur on requests that originate from a child business unit or that don't include one or more ContactKey values. Review your REST API requests for error messages related to these invalid requests.)
You can view this data in three different views.
- Day shows request volume and status for the past 24 hours.
- Week shows request volume and status for the past 7 days.
- Month shows request volume and status for the past 30 days.
You can also click the graph or chart to see individual contact delete requests. This dashboard shows information for any requests made in Marketing Cloud or via the REST API. Speaking of REST API, the next section covers how to use REST API calls to automate your contact delete requests or make them in bulk batches.