---
title: "POST /v1/{+parent}/dnsZones:add"
method: POST
path: "/v1/{+parent}/dnsZones:add"
tags: ["services"]
---

# POST /v1/{+parent}/dnsZones:add

`POST /v1/{+parent}/dnsZones:add`

Service producers can use this method to add private DNS zones in the shared producer host project and matching peering zones in the consumer project.

## Path parameters

- `parent` string, required

## Request body

- AddDnsZoneRequest — Request to add a private managed DNS zone in the shared producer host project and a matching DNS peering zone in the consumer project.
  - `name` string — Required. The name for both the private zone in the shared producer host project and the peering zone in the consumer project. Must be unique within both projects. The name must be 1-63 characters long, must begin with a letter, end with a letter or digit, and only contain lowercase letters, digits or dashes.
  - `dnsSuffix` string — Required. The DNS name suffix for the zones e.g. `example.com.`. Cloud DNS requires that a DNS suffix ends with a trailing dot.
  - `consumerNetwork` string — Required. The network that the consumer is using to connect with services. Must be in the form of projects/{project}/global/networks/{network} {project} is the project number, as in '12345' {network} is the network name.

## Response `200`

Successful response

---

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