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

# POST /v1/{+parent}/appConnections

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

Creates a new AppConnection in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `appConnectionId` string
- `requestId` string
- `validateOnly` boolean

## Request body

- GoogleCloudBeyondcorpAppconnectionsV1AppConnection — A BeyondCorp AppConnection resource represents a BeyondCorp protected AppConnection to a remote application. It creates all the necessary GCP components needed for creating a BeyondCorp protected AppConnection. Multiple connectors can be authorized for a single AppConnection.
  - `updateTime` string, google-datetime — Output only. Timestamp when the resource was last modified.
  - `applicationEndpoint` GoogleCloudBeyondcorpAppconnectionsV1AppConnectionApplicationEndpoint — ApplicationEndpoint represents a remote application endpoint.
    - `host` string — Required. Hostname or IP address of the remote application endpoint.
    - `port` integer — Required. Port of the remote application endpoint.
  - `name` string — Required. Unique resource name of the AppConnection. The name is ignored when creating a AppConnection.
  - `displayName` string — Optional. An arbitrary user-provided name for the AppConnection. Cannot exceed 64 characters.
  - `labels` object — Optional. Resource labels to represent user provided metadata.
  - `uid` string — Output only. A unique identifier for the instance generated by the system.
  - `type` 'TYPE_UNSPECIFIED' | 'TCP_PROXY' — Required. The type of network connectivity used by the AppConnection.
  - `gateway` GoogleCloudBeyondcorpAppconnectionsV1AppConnectionGateway — Gateway represents a user facing component that serves as an entrance to enable connectivity.
    - `type` 'TYPE_UNSPECIFIED' | 'GCP_REGIONAL_MIG' — Required. The type of hosting used by the gateway.
    - `uri` string — Output only. Server-defined URI for this resource.
    - `appGateway` string — Required. AppGateway name in following format: `projects/{project_id}/locations/{location_id}/appgateways/{gateway_id}`
    - `l7psc` string — Output only. L7 private service connection for this resource.
    - `ingressPort` integer — Output only. Ingress port reserved on the gateways for this AppConnection, if not specified or zero, the default port is 19443.
  - `connectors` string[] — Optional. List of [google.cloud.beyondcorp.v1main.Connector.name] that are authorized to be associated with this AppConnection.
  - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'CREATED' | 'UPDATING' | 'DELETING' | 'DOWN' — Output only. The current state of the AppConnection.
  - `satisfiesPzs` boolean — Output only. Reserved for future use.
  - `createTime` string, google-datetime — Output only. Timestamp when the resource was created.
  - `satisfiesPzi` boolean — Output only. Reserved for future use.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/beyondcorp.md) · [All operations](https://skmtc.dev/google/apis/beyondcorp/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/beyondcorp/revisions/e86980a523a5/schema)