Delete a List

Permanently delete a specific subscriber list by its unique list UID. This action removes all associated list data and cannot be undone.

🗑️ Delete a List

Remove a subscriber list permanently using its unique list ID. This action cannot be undone.

🔹 HTTP Request

DELETE API-URL/lists/LIST-UNIQUE-ID

🔸 URL Segments

Segment	Required	Description
LIST-UNIQUE-ID	Yes	Unique identifier of the list to delete.

🔐 Authorization Header

Include your customer API key:

X-API-KEY: your-api-key-here

💻 PHP Example

// delete a list
$response = $endpoint->delete('LIST-UNIQUE-ID');

// DISPLAY RESPONSE
echo '<hr /><pre>';
print_r($response->body);
echo '</pre>';

📦 Sample JSON Response

{
  "status": "success"
}

Deleting a list is a permanent action. All associated data will be lost and cannot be recovered.