Skip to main content
Add a trusted IP address. Once any IP is allowlisted, all requests from non-listed IPs are rejected with 403 Forbidden. 
POST https://api.yativo.com/api/v1/ip
Requires Idempotency-Key header. Confirm your server’s outbound IP before adding — adding a wrong IP could lock you out.
​
ip_address
string
required
IPv4 address to allowlist (e.g. "203.0.113.10").
​
label
string
Descriptive label for this IP (e.g. "Production server").
curl -X POST 'https://api.yativo.com/api/v1/ip' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: add-ip-001' \
  -d '{
    "ip_address": "203.0.113.10",
    "label": "Production server"
  }'

{
  "status": "success",
  "status_code": 200,
  "message": "IP addresses whitelisted and added to firewall."
}