Sign in
Track Customers

Delete a customer

Deleting a customer removes them, and all of their information, from Customer.io.

NOTE: Calls that update customers by ID can also create a customer. If you send data to Customer.io through other means (like the Javascript snippet), after you delete a customer, you may accidentally recreate the customer. You cannot delete a customer using the Javascript snippet alone.

delete/api/v1/customers/{identifier}

Path parameters

string required

The unique identifier for a person that you want to create or modify.

OR
string required

A person's email address. If adding a new person in an email-based workspace, you must use this value.

OR
string cio_[a-zA-Z0-9]* required

A canonical identifier assigned by Customer.io when you add a person. When referencing a person by this value, you must prefix the value with cio_. You can look up a person using the App API to find their cio_id.

You must use this value to update a person's other identifiers—their id or email, unless you enable your workspace's Allow updates to email using ID setting.

Example:person@example.com

The unique value representing a person. The values you use to identify a person may be an id, email address, or the cio_id (when updating people), depending on your workspace settings. When you reference people by cio_id, you must prefix the value with cio_.

You can't reference a person by their phone number here. We determine the identifier type from the shape of the value, so a phone number in the path is treated as an id. To identify people by phone number, use the Track v2 API.

Response

A successful request returns an empty object response.

Changes

No recorded changes to this endpoint across all 1 revision of this API.