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

# POST /v1/{+parent}/appgroups

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

Creates an AppGroup. Once created, user can register apps under the AppGroup to obtain secret key and password. At creation time, the AppGroup's state is set as `active`.

## Path parameters

- `parent` string, required

## Request body

- GoogleCloudApigeeV1AppGroup — AppGroup contains the request/response fields representing the logical grouping of apps. Note that appgroup_id, create_time and update_time cannot be changed by the user, and gets updated by the system. The name and the organization once provided cannot be edited subsequently.
  - `appGroupId` string — Output only. Internal identifier that cannot be edited
  - `attributes` GoogleCloudApigeeV1Attribute[] — A list of attributes
    - `name` string — API key of the attribute.
    - `value` string — Value of the attribute.
  - `email` string — Optional. Email of the AppGroup.
  - `displayName` string — app group name displayed in the UI
  - `channelUri` string — A reference to the associated storefront/marketplace.
  - `status` string — Valid values are `active` or `inactive`. Note that the status of the AppGroup should be updated via UpdateAppGroupRequest by setting the action as `active` or `inactive`.
  - `createdAt` string, int64 — Output only. Created time as milliseconds since epoch.
  - `channelId` string — channel identifier identifies the owner maintaing this grouping.
  - `lastModifiedAt` string, int64 — Output only. Modified time as milliseconds since epoch.
  - `name` string — Immutable. Name of the AppGroup. Characters you can use in the name are restricted to: A-Z0-9._\-$ %.
  - `organization` string — Immutable. the org the app group is created

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