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

# POST /v1/{+parent}/gateways

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

Creates a new Gateway in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `gatewayId` string

## Request body

- ApigatewayGateway — A Gateway is an API-aware HTTP proxy. It performs API-Method and/or API-Consumer specific actions based on an API Config such as authentication, policy enforcement, and backend selection.
  - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'ACTIVE' | 'FAILED' | 'DELETING' | 'UPDATING' — Output only. The current state of the Gateway.
  - `labels` object — Optional. Resource labels to represent user-provided metadata. Refer to cloud documentation on labels for more details. https://cloud.google.com/compute/docs/labeling-resources
  - `createTime` string, google-datetime — Output only. Created time.
  - `displayName` string — Optional. Display name.
  - `updateTime` string, google-datetime — Output only. Updated time.
  - `defaultHostname` string — Output only. The default API Gateway host name of the form `{gateway_id}-{hash}.{region_code}.gateway.dev`.
  - `name` string — Output only. Resource name of the Gateway. Format: projects/{project}/locations/{location}/gateways/{gateway}
  - `apiConfig` string — Required. Resource name of the API Config for this Gateway. Format: projects/{project}/locations/global/apis/{api}/configs/{apiConfig}

## Response `200`

Successful response

---

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