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

# POST /v1/{+parent}/apimServiceExtensions

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

Creates an APIM ServiceExtension in an organization.

## Path parameters

- `parent` string, required

## Query parameters

- `apimServiceExtensionId` string

## Request body

- GoogleCloudApigeeV1ApimServiceExtension — APIM Service Extension is a resource under an Apigee Organization that is used to create APIM Service Extension to route traffic to existing X instances.
  - `networkConfigs` GoogleCloudApigeeV1ApimServiceExtensionNetworkConfig[] — Required. List of network configurations for the APIM service extension.
    - `region` string — Required. The region for the PSC NEG.
    - `subnet` string — Required. The subnet for the PSC NEG. Format: projects/{project}/regions/{region}/subnetworks/{subnet}
  - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'ACTIVE' | 'DELETING' | 'UPDATING' — Output only. State of the APIM service extension. Values other than `ACTIVE` mean the resource is not ready to use.
  - `extensions` GoogleCloudApigeeV1ApimServiceExtensionExtension[] — Optional. List of extensions that are part of the service extension. Refer to https://cloud.google.com/service-extensions/docs/quotas#limits for any limits.
    - `name` string — Required. Name of the `LbTrafficExtension` resource. The name must conform with RFC-1034, is restricted to lower-cased letters, numbers and hyphens, and can have a maximum length of 63 characters. Additionally, the first character must be a letter and the last a letter or a number.
    - `matchCondition` string — Optional. Match Condition for CEL expression. Refer to https://cloud.google.com/service-extensions/docs/cel-matcher-language-reference for more details.
    - `failOpen` boolean — Optional. Whether this request should fail open.
    - `hostname` string — Required. One of the hostnames of Apigee EnvGroup where the proxy is deployed. This hostname (i.e FDQN) will be used to route traffic from the specified forwarding rule to the environment in Apigee X instance where the proxy is deployed for handling extension traffic. Format: ^([a-zA-Z0-9. _-])+$
    - `supportedEvents` string[] — Optional. Supported events for the Service Extension. If not specified, all events are supported.
  - `name` string — Identifier. unique name of the APIM service extension. The name must conform with RFC-1034, is restricted to lower-cased letters, numbers and hyphens, and can have a maximum length of 63 characters. Additionally, the first character must be a letter and the last a letter or a number.
  - `lbForwardingRule` string — Required. Name of the Google Cloud LB forwarding rule. Format: projects/{project}/regions/{region}/forwardingRules/{forwarding_rule} projects/{project}/global/forwardingRules/{forwarding_rule}
  - `createTime` string, google-datetime — Output only. The time that this resource was created on the server.
  - `network` string — Required. The network where the forwarding rule is created. Format: projects/{project}/global/networks/{network}
  - `extensionProcessor` string — Required. Name of the proxy deployed in the Apigee X instance.
  - `updateTime` string, google-datetime — Output only. The time that this resource was updated on the server.

## Response `200`

Successful response

---

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