Create an IP group
curl --request POST \
--url https://console.advinservers.com/api/v1/client/ip-groups \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Sector C lab"
}
'import requests
url = "https://console.advinservers.com/api/v1/client/ip-groups"
payload = { "name": "Sector C lab" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'Sector C lab'})
};
fetch('https://console.advinservers.com/api/v1/client/ip-groups', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://console.advinservers.com/api/v1/client/ip-groups",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Sector C lab'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://console.advinservers.com/api/v1/client/ip-groups"
payload := strings.NewReader("{\n \"name\": \"Sector C lab\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://console.advinservers.com/api/v1/client/ip-groups")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Sector C lab\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://console.advinservers.com/api/v1/client/ip-groups")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Sector C lab\"\n}"
response = http.request(request)
puts response.read_body{
"id": "145e6e6f-a6b0-4b9e-9060-2d4f017baff8",
"name": "Sector C lab",
"entries": [],
"rules_count": 0,
"created_at": "2026-09-14T16:42:09+00:00",
"used_by": []
}{
"message": "Unauthenticated."
}{
"message": "This API key is not allowed to do that in this team. It needs the \"snapshot.delete\" permission."
}{
"message": "The name field is required.",
"errors": {}
}{
"message": "Too Many Attempts."
}IP groups
Create an IP group
Overview
Creates an empty IP group in the current team. Send a name unique across the account, up to 100 characters, using letters, numbers, spaces, dots, dashes or underscores. Add addresses, then use the group as a firewall rule source.
Permissions
Requires the firewall.update (Change the firewall) permission for the selected team. Resources outside that team return 404.
POST
/
ip-groups
Create an IP group
curl --request POST \
--url https://console.advinservers.com/api/v1/client/ip-groups \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Sector C lab"
}
'import requests
url = "https://console.advinservers.com/api/v1/client/ip-groups"
payload = { "name": "Sector C lab" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'Sector C lab'})
};
fetch('https://console.advinservers.com/api/v1/client/ip-groups', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://console.advinservers.com/api/v1/client/ip-groups",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Sector C lab'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://console.advinservers.com/api/v1/client/ip-groups"
payload := strings.NewReader("{\n \"name\": \"Sector C lab\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://console.advinservers.com/api/v1/client/ip-groups")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Sector C lab\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://console.advinservers.com/api/v1/client/ip-groups")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Sector C lab\"\n}"
response = http.request(request)
puts response.read_body{
"id": "145e6e6f-a6b0-4b9e-9060-2d4f017baff8",
"name": "Sector C lab",
"entries": [],
"rules_count": 0,
"created_at": "2026-09-14T16:42:09+00:00",
"used_by": []
}{
"message": "Unauthenticated."
}{
"message": "This API key is not allowed to do that in this team. It needs the \"snapshot.delete\" permission."
}{
"message": "The name field is required.",
"errors": {}
}{
"message": "Too Many Attempts."
}Authorizations
Your API key, sent as a bearer token. Create one in the control panel under API Keys, give it only the permissions the integration needs, and copy it when it is created. It cannot be shown again. Each key is restricted to one owned team. The key determines the team for every request.
Body
application/json
Send a JSON object containing the fields below. Required fields are marked in the schema.
A name unique for this group type across the account, 1 to 100 characters. Use letters, numbers, spaces, dots, dashes or underscores.
Example:
"Sector C lab"
Response
The record, as a JSON object. There is no envelope.
A named list of addresses a customer points firewall rules at.
The id ID.
Example:
"145e6e6f-a6b0-4b9e-9060-2d4f017baff8"
The name shown to customers.
Example:
"Sector C lab"
The value of entries.
Show child attributes
Show child attributes
Example:
[
{
"id": "90c1a65c-b273-44a4-ae39-9f9e3c08c8b7",
"value": "192.0.2.0/28",
"comment": "Anomalous Materials test lab LAN"
},
{
"id": "936a228e-b576-4779-892b-ac30590dbe18",
"value": "192.0.2.44",
"comment": "Black Mesa VPN gateway"
}
]
How many firewall rules point at this group - what makes it unsafe to delete, so the list needs it even without the detail below.
Example:
1
The date and time for created at, in UTC.
Example:
"2026-03-02T19:24:51+00:00"
Which firewall groups use this one, named.
Show child attributes
Show child attributes