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

# POST /v1/{+parent}/apps

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

Creates an app and associates it with an AppGroup. This API associates the AppGroup app with the specified API product and auto-generates an API key for the app to use in calls to API proxies inside that API product. The `name` is the unique ID of the app that you can use in API calls.

## Path parameters

- `parent` string, required

## Request body

- GoogleCloudApigeeV1AppGroupApp — Response for [GetAppGroupApp].[AppGroupApps.GetAppGroupApp], [CreateAppGroupAppRequest].[AppGroupApp.CreateAppGroupAppRequest] and [DeleteAppGroupApp].[AppGroupApp.DeleteAppGroupApp]
  - `attributes` GoogleCloudApigeeV1Attribute[] — List of attributes for the AppGroup app.
    - `name` string — API key of the attribute.
    - `value` string — Value of the attribute.
  - `callbackUrl` string — Callback URL used by OAuth 2.0 authorization servers to communicate authorization codes back to AppGroup apps.
  - `appId` string — Immutable. ID of the AppGroup app.
  - `credentials` GoogleCloudApigeeV1Credential[] — Output only. Set of credentials for the AppGroup app consisting of the consumer key/secret pairs associated with the API products.
    - `attributes` GoogleCloudApigeeV1Attribute[] — List of attributes associated with this credential.
      - `name` string — API key of the attribute.
      - `value` string — Value of the attribute.
    - `scopes` string[] — List of scopes to apply to the app. Specified scopes must already exist on the API product that you associate with the app.
    - `consumerKey` string — Consumer key.
    - `consumerSecret` string — Secret key.
    - `expiresAt` string, int64 — Time the credential will expire in milliseconds since epoch.
    - `status` string — Status of the credential. Valid values include `approved` or `revoked`.
    - `apiProducts` GoogleCloudApigeeV1ApiProductRef[] — List of API products this credential can be used for.
      - `apiproduct` string — Name of the API product.
      - `status` string — Status of the API product. Valid values are `approved` or `revoked`.
    - `issuedAt` string, int64 — Time the credential was issued in milliseconds since epoch.
  - `keyExpiresIn` string, int64 — Immutable. Expiration time, in seconds, for the consumer key that is generated for the AppGroup app. If not set or left to the default value of `-1`, the API key never expires. The expiration time can't be updated after it is set.
  - `appGroup` string — Immutable. Name of the parent AppGroup whose resource name format is of syntax (organizations/*/appgroups/*).
  - `apiProducts` string[] — List of API products associated with the AppGroup app.
  - `scopes` string[] — Scopes to apply to the AppGroup app. The specified scopes must already exist for the API product that you associate with the AppGroup app.
  - `name` string — Immutable. Name of the AppGroup app whose resource name format is of syntax (organizations/*/appgroups/*/apps/*).
  - `lastModifiedAt` string, int64 — Output only. Time the AppGroup app was modified in milliseconds since epoch.
  - `createdAt` string, int64 — Output only. Time the AppGroup app was created in milliseconds since epoch.
  - `status` string — Status of the App. Valid values include `approved` or `revoked`.

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