Delete profiles and suppress profile IDs

Updated

You can delete profiles from Customer.io from our UI or API. No matter which method you choose, when you delete a profile, you’re deleting their data with them too. There is no way to recover a deleted profile’s data!

If you are honoring a profile’s request to be forgotten, or simply want to prevent an identifier from being added to your Customer.io workspace in the future, you can suppress that identifier when deleting profiles.

Types of suppressions

Suppressions can mean a few different things:

  • In Customer.io, you can suppress a deleted profile’s identifiers so they can’t ever be re-added to your workspace (good for GDPR compliance).
  • Email service providers (ESP) suppress an email address to help you maintain good deliverability.

Email service providers (ESP) maintain lists of suppressed email addresses when profiles log a spam complaint or the address experiences a hard-bounce. ESPs won’t send to suppressed email addresses. If you use Customer.io as your ESP, you can view and manage your list in Workspace Settings > Email > Suppression List.

The email suppression list page
The email suppression list page

Otherwise, if you use a Custom SMTP server, you must manage your email suppression list through them.

Delete profiles

You can delete profiles in bulk or individually in your workspace. Go to the Profiles page to get started.

Delete profiles in bulk

You can filter for, select and delete individuals from the Profiles page.

delete_people_page_1.png
delete_people_page_1.png

Alternatively, if you need to delete all of the profiles included in your search results (such as those matching a specific segment), click Select all ### profiles:

delete_people_page_2.png
delete_people_page_2.png

When you’re ready, click Delete forever to confirm your action.

Delete a single profile

You can delete a single profile with the method above or by clicking Delete forever on their individual page:

image.png
image.png

Once again, confirm that you want to delete them, and you’re good to go!

Delete profiles via API

You can delete profiles directly via API or through a webhook action in an automation.

See our Track API documentation for help deleting profiles programmatically.

Remember, if you’re sending data to Customer.io via other means (such as the JavaScript snippet), you can re-create profiles you’ve deleted! To avoid this, you should delete AND suppress their identifiers.

 Use the correct URL for your region

If your account is based in the European Union (EU), make sure you use endpoints beginning with track-eu. We redirect traffic from US endpoints to EU-based accounts, however the traffic still passes through US servers and data may be logged in the US.

How suppressing IDs works

You can “suppress” profiles you delete. Suppressing a profile redacts activity attributed to the profile and prevents you from adding a profile with the same identifiersThe attributes you use to add, modify, and target people. Each unique identifier value represents an individual person in your workspace. to your workspace in the future. This is typically used for GDPR compliance.

Suppressing a profile suppresses all of their identifiers, but consider how you identify profiles according to your workspace’s settings:

  • If your workspace is ID-only, suppressing a profile suppresses their ID.
  • If your workspace identifies profiles by email, phone, or ID and you suppress a profile, you cannot add another profile with the same id, email, or phone; all of their identifiers are suppressed.

If you need to export a list of suppressed identifiers, contact Customer.io.

 Changing workspace identifiers affects suppression

If you have an ID-only workspace and you change your workspace settings to email or ID, the email attribute belonging to suppressed profiles will also be suppressed.

If you delete and suppress a profile’s identifiers:

  • You cannot reuse the deleted profile’s identifiersThe attributes you use to add, modify, and target people. Each unique identifier value represents an individual person in your workspace. until you unsuppress them.
  • Any attempt to re-add a profile with a suppressed id, email, or phone is ignored or results in an error (CSV imports, API).
  • Activity attributed to the deleted and suppressed identifier (the profile) is redacted. Profile activity shows forgotten (anonymous) entries for suppressed identifiers.

If you delete and don’t suppress a profile’s identifiers:

Suppress IDs

After you click Delete forever, you’ll need to confirm your action and decide whether to suppress the profile’s identifiers.

The dialog to delete and suppress a profile
The dialog to delete and suppress a profile

Suppress IDs via API

You can suppress an identifier to redact activity attributed to it and prevent a profile from being added to your workspace with the same identifier again.

You can delete and suppress profiles directly via API or through a webhook action in an automation.

If you suppress an identifier, we’ll ignore API calls referencing the identifier in the future. If you attempt to re-add a profile using an identifier that you previously suppressed, you’ll receive an error.

Suppressing a profile through our API also deletes a profile. You don’t need to call both the delete and suppress endpoints.

Use the following call, where the identifier is any of your workspace’s unique identifiers (normally id and email).

POST https://track.customer.io/api/v1/customers/:identifier/suppress

For more information, see our Track API documentation.

 You can only suppress profiles by phone through the Track v2 API

The v1 suppress and unsuppress endpoints resolve the path identifier as an id or email only—a phone number in the path is treated as an id. To suppress or unsuppress a profile by their phone number, use the Track v2 API. Regardless of which identifier you reference, suppressing a profile still suppresses all of their identifiers, including phone.

 Use the correct URL for your region

If your account is based in the European Union (EU), make sure you use endpoints beginning with track-eu. We redirect traffic from US endpoints to EU-based accounts, however the traffic still passes through US servers and data may be logged in the US.

Unsuppress IDs

If you previously suppressed a profile’s identifiers, you can unsuppress them so they’re available to use again in your workspace. If you add a profile with the unsuppressed ids, we make a new profile without any history (messages, journeys, etc.) formerly associated with the ids.

You can unsuppress ids from the UI in > Workspace Settings > Workspace Suppressions.

You can also unsuppress deleted ids programmatically through the Track API.

 Use the correct URL for your region

If your account is based in the European Union (EU), make sure you use endpoints beginning with track-eu. We redirect traffic from US endpoints to EU-based accounts, however the traffic still passes through US servers and data may be logged in the US.
Copied to clipboard!