API ReferenceAllowlist

Allowlist an IP

Let a server use the gateway without credentials.

POSThttps://api.riftip.com/v1/allowlist

#Body parameters

Parameter	Type	Description
`ip`	string, required	IPv4 or IPv6 address of a server you control.
`label`	string	Up to 60 characters, for your own reference.

#Request

curl -X POST https://api.riftip.com/v1/allowlist \
  -H "Authorization: Bearer $RIFTIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ip": "198.51.100.14", "label": "scraper-3" }'

await fetch("https://api.riftip.com/v1/allowlist", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.RIFTIP_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ ip: "198.51.100.14", label: "scraper-3" }),
});

requests.post(
    "https://api.riftip.com/v1/allowlist",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"ip": "198.51.100.14", "label": "scraper-3"},
)

#Response

201 Created

JSON

{ "ip": "198.51.100.14", "label": "scraper-3", "created_at": "2026-10-20T09:51:00Z" }

Changes take effect on the gateway within about 30 seconds. An account can allowlist up to 100 IPs.

Heads up

Only allowlist IPs you control exclusively — anyone sending traffic from them is treated as you.