---
title: "POST /v1/{+parent}/addressGroups"
method: POST
path: "/v1/{+parent}/addressGroups"
tags: ["projects"]
---

# POST /v1/{+parent}/addressGroups

`POST /v1/{+parent}/addressGroups`

Creates a new address group in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `addressGroupId` string
- `requestId` string

## Request body

- AddressGroup — AddressGroup is a resource that specifies how a collection of IP/DNS used in Firewall Policy.
  - `labels` object — Optional. Set of label tags associated with the AddressGroup resource.
  - `description` string — Optional. Free-text description of the resource.
  - `purpose` string[] — Optional. List of supported purposes of the Address Group.
  - `createTime` string, google-datetime — Output only. The timestamp when the resource was created.
  - `type` 'TYPE_UNSPECIFIED' | 'IPV4' | 'IPV6' — Required. The type of the Address Group. Possible values are "IPv4" or "IPV6".
  - `items` string[] — Optional. List of items.
  - `capacity` integer — Required. Capacity of the Address Group
  - `selfLink` string — Output only. Server-defined fully-qualified URL for this resource.
  - `updateTime` string, google-datetime — Output only. The timestamp when the resource was updated.
  - `name` string — Required. Name of the AddressGroup resource. It matches pattern `projects/*/locations/{location}/addressGroups/`.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/networksecurity.md) · [All operations](https://skmtc.net/google/apis/networksecurity/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/networksecurity/versions/4afd54463fe6/schema)