Deleting a User Profile

CustomerLabs supports permanent deletion of user profiles to comply with GDPR right-to-erasure requests and similar privacy regulations. Deletion can be initiated via the CustomerLabs dashboard or through the API.

Danger

Deletion requests are processed after 24 hours. You can cancel a request within this window. After 24 hours, the deletion is permanent and the data cannot be recovered.

Users can be identified for deletion using any of the following:

• CustomerLabs User ID
• Email address
• Phone number
• Facebook fbp
• Google Analytics Client ID
• Any external ID configured in your source (e.g., HubSpot ID, Intercom Visitor ID)

---

Method 1 — Delete via CustomerLabs Dashboard

Find the User

1. Navigate to Audience → Find User and click Find User.

   
   

2. Select the identifying key from the dropdown (e.g., email, phone, CustomerLabs User ID).

   

3. Enter the corresponding value and click Find Data.

   

Initiate Deletion

1. Once the user profile is returned, click the delete icon on the profile.

   
   

2. Copy the displayed User ID, paste it into the confirmation field, and confirm the deletion request.

   

Monitor Deletion Status

Track the status of deletion requests under Audience → Find User → User Deletion Logs.

Cancel a Deletion Request

Deletion requests can be cancelled within 24 hours of submission. Navigate to Audience → Delete User, locate the relevant entry, and click Cancel Request. Paste the User ID into the confirmation field and confirm.

The status will update to Cancelled in the deletion logs.

---

Method 2 — Delete via API

Generate an API Key

1. Navigate to Settings → API Key and click Generate Key.

   
   

2. Copy and securely store the generated API key.

   

   Caution

   Only admin-level users can generate API keys. Store the key securely — do not expose it in client-side code or version control. To invalidate an existing key, navigate to Settings → API Key → Reset Key.

Delete a User

Send a POST request to the deletion endpoint with the user’s identifying key and value.

Endpoint: https://api.customerlabs.co/user-deletion/

cURL

curl --location 'https://api.customerlabs.co/user-deletion/' \
--header 'X-API-Key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "identify_by_key": "email",
    "identify_by_value": "[email protected]"
}'

Success response:

JSON

{
  "success": true,
  "message": "User Deletion has been added to queue"
}

Cancel a Deletion Request

Send a POST request to the cancel endpoint within 24 hours of the original deletion request.

Endpoint: https://api.customerlabs.co/user-deletion/cancel-request/

cURL

curl --location 'https://api.customerlabs.co/user-deletion/cancel-request/' \
--header 'X-API-Key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "identify_by_key": "email",
    "identify_by_value": "[email protected]"
}'

Success response:

JSON

{
  "success": true,
  "message": "User deletion request has been cancelled"
}

Error Responses

HTTP Status	Response	Cause
403	{"message": "Forbidden"}	Invalid or missing API key
200	{"success": false, "message": "No delete record found for this query"}	No matching user found for the given identifier