# Create a special list for API-TOOL

For more information look [`here`](https://docs.proxy-seller.com/proxy-seller/residential-proxy/api-tool).

Lists are created with the same name, but you can rename them if you wish.

### **Endpoint:**

<mark style="color:blue;">`PUT`</mark> `https://proxy-seller.com/personal/api/v1/{YourApiKey}/residentsubuser/list/tools`

#### **Example:**

```
https://proxy-seller.com/personal/api/v1/fj4948ffhg58gh843gh/residentsubuser/list/tools
```

### **Response:**

{% tabs %}
{% tab title="200: OK Success response " %}

```json
{
  "status": "success",
  "data": {
    "id": 561,
    "login": "api3c8aa1d4",
    "password": "AZT62Dx3"
  },
  "errors": []
}
```

{% endtab %}

{% tab title="200: OK Error response Wrong API key" %}

```json
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Error api key",
            "code": 503,
            "customData": null
        },
        {
            "message": "IP not allowed",
            "code": 503,
            "customData": null
        },
        {
            "message": "Request limit reached",
            "code": 503,
            "customData": null
        }
    ]
}
```

{% endtab %}

{% tab title="200: OK Error response Wrong authorization IP" %}

```json
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "IP not allowed",
            "code": 503,
            "customData": null
        }
    ]
}
```

{% endtab %}

{% tab title="200: OK Error response Tarif not found" %}

```json
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Tarif not found",
            "code": 0,
            "customData": null
        }
    ]
}
```

{% endtab %}
{% endtabs %}

### **Path parameters:**

<table data-full-width="false"><thead><tr><th width="153">Name</th><th width="186">Value</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Authorization</td><td><code>&#x3C;Your_API_Key></code></td><td>Your personal API key</td><td></td></tr></tbody></table>

### **Request body:**

<table><thead><tr><th width="144">Name</th><th width="91">Type</th><th>Description</th></tr></thead><tbody><tr><td>package_key</td><td>String</td><td>The key of the subuser's package where you want to create the special list.</td></tr></tbody></table>