---
title: "Create new Address object"
slug: "create-new-address-object"
updated: 2026-02-18T12:52:38Z
published: 2026-02-18T12:52:58Z
canonical: "support.perimeter81.com/create-new-address-object"
---

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

# Create new Address object

Post/v2.3/objects/addresses

Required permission: `["objects:create"]`.

SecurityHTTPType bearer

Body parameters<select class='api-response-data' aria-label='Media type'><option value='85878edb-cbff-4399-8f14-1dc7e9ffbc01'>application/json</option>
</select>object  idstring    

Unique Address ID

namestring    Required

The name of the Objects

Min length3Max length100Pattern^[a-zA-Z0-9_ ]+$
descriptionstring    
OneOfObjectsAddressIPobject (ObjectsAddressIP)valueTypestring    RequiredValid values[
  "ip"
]
value Array of string (IP)   RequiredMin items1Max items1string  (ipv4)    

ObjectsAddressIPListobject (ObjectsAddressIPList)valueTypestring    RequiredValid values[
  "list"
]
value Array of string (IP)   Required

Must be a unique list of IPs

Min items1string  (ipv4)    

ObjectsAddressCIDRobject (ObjectsAddressCIDR)valueTypestring    RequiredValid values[
  "cidr"
]
value Array of string (CIDR)   RequiredMin items1Max items1string    Pattern^((?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3})(\/(3[0-2]|[1-2][0-9]|[0-9]))$

ObjectsAddressFQDNobject (ObjectsAddressFQDN)valueTypestring    RequiredValid values[
  "fqdn"
]
value Array of string (FQDN)   RequiredMin items1Max items1string    Pattern(?=^.{4,253}$)(^((?!-)[a-zA-Z0-9-]{0,62}[a-zA-Z0-9]\.)+[a-zA-Z]{2,63}$)

Responses201

Created successfully

<select class='api-response-data' aria-label='Media type'><option value='dc17dd14-ce4d-4ad2-a38b-733e8630bd28'>application/json</option>
</select>object  idstring    
namestring    

The name of the Objects

Min length3Max length100Pattern^[a-zA-Z0-9_ ]+$
descriptionstring    
OneOfObjectsAddressIPobject (ObjectsAddressIP)valueTypestring    Valid values[
  "ip"
]
value Array of string (IP)   Min items1Max items1string  (ipv4)    

ObjectsAddressIPListobject (ObjectsAddressIPList)valueTypestring    Valid values[
  "list"
]
value Array of string (IP)   

Must be a unique list of IPs

Min items1string  (ipv4)    

ObjectsAddressCIDRobject (ObjectsAddressCIDR)valueTypestring    Valid values[
  "cidr"
]
value Array of string (CIDR)   Min items1Max items1string    Pattern^((?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3})(\/(3[0-2]|[1-2][0-9]|[0-9]))$

ObjectsAddressFQDNobject (ObjectsAddressFQDN)valueTypestring    Valid values[
  "fqdn"
]
value Array of string (FQDN)   Min items1Max items1string    Pattern(?=^.{4,253}$)(^((?!-)[a-zA-Z0-9-]{0,62}[a-zA-Z0-9]\.)+[a-zA-Z]{2,63}$)

400

Bad request

401

Unauthorized

403

Forbidden