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

# POST /v1/{+parent}/firewallEndpoints

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

Creates a new FirewallEndpoint in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `firewallEndpointId` string
- `requestId` string

## Request body

- FirewallEndpoint — Message describing Endpoint object.
  - `description` string — Optional. Description of the firewall endpoint. Max length 2048 characters.
  - `labels` object — Optional. Labels as key value pairs
  - `reconciling` boolean — Output only. Whether reconciling is in progress, recommended per https://google.aip.dev/128.
  - `billingProjectId` string — Optional. Project to charge for the deployed firewall endpoint. This field must be specified when creating the endpoint in the organization scope, and should be omitted otherwise.
  - `endpointSettings` FirewallEndpointEndpointSettings — Settings for the endpoint.
    - `jumboFramesEnabled` boolean — Optional. Immutable. Indicates whether Jumbo Frames are enabled. Default value is false.
  - `createTime` string, google-datetime — Output only. Create time stamp.
  - `associatedNetworks` string[] — Output only. Deprecated: List of networks that are associated with this endpoint in the local zone. This is a projection of the FirewallEndpointAssociations pointing at this endpoint. A network will only appear in this list after traffic routing is fully configured. Format: projects/{project}/global/networks/{name}.
  - `satisfiesPzi` boolean — Output only. [Output Only] Reserved for future use.
  - `associations` FirewallEndpointAssociationReference[] — Output only. List of FirewallEndpointAssociations that are associated to this endpoint. An association will only appear in this list after traffic routing is fully configured.
    - `name` string — Output only. The resource name of the FirewallEndpointAssociation. Format: projects/{project}/locations/{location}/firewallEndpointAssociations/{id}
    - `network` string — Output only. The VPC network associated. Format: projects/{project}/global/networks/{name}.
  - `satisfiesPzs` boolean — Output only. [Output Only] Reserved for future use.
  - `name` string — Immutable. Identifier. Name of resource.
  - `updateTime` string, google-datetime — Output only. Update time stamp
  - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'ACTIVE' | 'DELETING' | 'INACTIVE' — Output only. Current state of the endpoint.

## 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)