CUcustomer
Track Customers

Delete a customer

Changed on

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}

Request

  • Base URL
    https://track.customer.io
  • URL
    https://track.customer.io/api/v1/customers/{identifier}
  • Auth
    • HTTP bearer
    • or HTTP basic

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

  • 7a1d33d191acRevision changes
    • info

      the endpoint scheme security Track-Bearer-Auth was added to the API

    • info

      added the non-success response with the status