Copy a List

Create an exact duplicate of an existing list, including settings but excluding subscribers. A new unique list UID is returned in the response.

📄 Copy a List

Duplicate an existing subscriber list using its unique ID.

🔹 HTTP Request

POST API-URL/lists/LIST-UNIQUE-ID/copy

🔸 URL Segments

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

🔐 Authorization Header

Include your customer API key:

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

💻 PHP Example

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

// DISPLAY RESPONSE
echo '<hr /><pre>';
print_r($response->body);
echo '</pre>';
The above command returns an object structured like this JSON:

{
  "status":"success",
  "list_uid": "lm451q7h7j3e2"
}

📦 Sample JSON Response

{
  "status": "success",
  "list_uid": "lm451q7h7j3e2"
}

📌 This endpoint creates an exact duplicate of the specified list, including its settings, but not its subscribers.