> For the complete documentation index, see [llms.txt](https://api.senderwiz.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api.senderwiz.com/customer/contact-list/copy-a-list.md).

# 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

```http
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

```php
// 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

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

{% hint style="warning" %}
📌 This endpoint creates an exact duplicate of the specified list, including its settings, but not its subscribers.
{% endhint %}