# Adicionando um IP permitido

`POST https://api.oxylabs.io/v1/whitelisted_ips`

| Resposta | Descrição                                                                                                 |
| -------- | --------------------------------------------------------------------------------------------------------- |
| `201`    | Sucesso. O endereço IP foi adicionado à lista. O corpo da resposta contém o `endereço` e `id`.            |
| `422`    | Erro. O corpo da requisição contém um endereço IP inválido. O corpo da resposta contém a mensagem de erro |

#### Exemplo de código

{% tabs %}
{% tab title="cURL" %}

```shell
curl -X POST -u username:password "https://api.oxylabs.io/v1/whitelisted_ips"
--header "Content-Type: application/json" --data '{"address": "127.0.0.1"}'
```

{% endtab %}

{% tab title="PHP" %}

```php
<?php
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, "https://api.oxylabs.io/v1/whitelisted_ips");
$payload = json_encode( array( "address"=> "127.0.0.1" ) );
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, $payload);
curl_setopt( $curl, CURLOPT_HTTPHEADER, array('Content-Type:application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_USERPWD, 'username:password');

$result = curl_exec($curl);
?>
```

{% endtab %}

{% tab title="Python" %}

```python
import requests
requests.post('https://api.oxylabs.io/v1/whitelisted_ips',
              json={"address": "127.0.0.1"},
              auth=('username', 'password'))
```

{% endtab %}
{% endtabs %}

```
{
    "error": {
        "message": "Este não é um endereço IP válido.",
        "code": 422
    }
}
```

#### Exemplo de saída

```
{
    "id": 9767,
    "address": "127.0.0.1"
}
```