Create an IP list
POST
/api/organizations/{organizationId}/ip-lists
Creates a named IP list of IPv4/IPv6 addresses or CIDR blocks within the organization. The name must be unique within the organization. Each entry must be a valid IP address or a canonical CIDR block (host bits must be zero), and entries must be unique and non-overlapping (an entry fully contained within another is rejected); at most 500 entries are allowed. IPv4-mapped IPv6 addresses (e.g. "::ffff:1.2.3.4") are rejected - use the plain IPv4 form.
Authorizations
ApiToken
Long-lived API token created via POST /api/api-tokens (returned once in plaintext).
Type
API Key (header: X-API-TOKEN)
or
JWT
JWT access token obtained via POST /api/auth/login. Send as: Authorization: Bearer
Type
HTTP (bearer)
Parameters
Path Parameters
organizationId*
Organization identifier
Type
Requiredstring
Request Body
JSON "name": "Office allowlist", "description": "Corporate office egress ranges", "entries": [ [ "203.0.113.0/24", "198.51.100.7", "2001:db8::/32" ] ]
{
}
Responses
ip-list resource created
JSON "@context": "string", "@id": "string", "@type": "string", "id": "0197c9a3-5f2e-7b41-9c8d-1a2b3c4d5e6f", "organization": "https://example.com/", "name": "Office allowlist", "description": "Corporate office egress ranges", "entries": [ [ "203.0.113.0/24", "198.51.100.7", "2001:db8::/32" ] ], "createdAt": "2026-07-01T12:00:00+00:00", "updatedAt": "2026-07-01T12:00:00+00:00"
{
}