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

# POST /v1/{+parent}/appConnectors

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

Creates a new AppConnector in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `appConnectorId` string
- `requestId` string
- `validateOnly` boolean

## Request body

- GoogleCloudBeyondcorpAppconnectorsV1AppConnector — A BeyondCorp connector resource that represents an application facing component deployed proximal to and with direct access to the application instances. It is used to establish connectivity between the remote enterprise environment and GCP. It initiates connections to the applications and can proxy the data from users over the connection.
  - `updateTime` string, google-datetime — Output only. Timestamp when the resource was last modified.
  - `resourceInfo` GoogleCloudBeyondcorpAppconnectorsV1ResourceInfo — ResourceInfo represents the information or status of an app connector resource component that's used to report on various parts of the system. For example, ResourceInfo can be used to convey the status of a remote_agent, including the status of an appgateway for an runtime environment in a container instance.
    - `time` string, google-datetime — The timestamp to collect the info. It is suggested to be set by the topmost level resource only.
    - `resource` object — Specific details for the resource. This is for internal use only.
    - `sub` GoogleCloudBeyondcorpAppconnectorsV1ResourceInfo[] — List of Info for the sub level resources.
    - `id` string — Required. Unique Id for the resource.
    - `status` 'HEALTH_STATUS_UNSPECIFIED' | 'HEALTHY' | 'UNHEALTHY' | 'UNRESPONSIVE' | 'DEGRADED' — Overall health status. Overall status is derived based on the status of each sub level resources.
  - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'CREATED' | 'UPDATING' | 'DELETING' | 'DOWN' — Output only. The current state of the AppConnector.
  - `name` string — Required. Unique resource name of the AppConnector. The name is ignored when creating a AppConnector.
  - `displayName` string — Optional. An arbitrary user-provided name for the AppConnector. Cannot exceed 64 characters.
  - `labels` object — Optional. Resource labels to represent user provided metadata.
  - `createTime` string, google-datetime — Output only. Timestamp when the resource was created.
  - `uid` string — Output only. A unique identifier for the instance generated by the system.
  - `principalInfo` GoogleCloudBeyondcorpAppconnectorsV1AppConnectorPrincipalInfo — PrincipalInfo represents an Identity oneof.
    - `serviceAccount` GoogleCloudBeyondcorpAppconnectorsV1AppConnectorPrincipalInfoServiceAccount — ServiceAccount represents a GCP service account.
      - `email` string — Email address of the service account.

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