> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yativo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add IP Addresses

> Add one or more IP addresses to your API allowlist

Add trusted IP addresses to your allowlist. Once any IP is allowlisted, all requests from non-listed IPs are rejected with `403 Forbidden`.

```
POST https://api.yativo.com/api/v1/ip
```

<Note>
  Requires an `Idempotency-Key` header. Confirm your server's outbound IP before adding — adding a wrong IP could lock you out.
</Note>

## Request body

<ParamField body="new_ip" type="array" required>
  Array of IPv4 address strings to allowlist.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST 'https://api.yativo.com/api/v1/ip' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
    -H 'Content-Type: application/json' \
    -H 'Idempotency-Key: ip-add-001' \
    -d '{
      "new_ip": ["203.0.113.10", "198.51.100.5"]
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "message": "IP addresses whitelisted and added to firewall."
  }
  ```
</ResponseExample>