Method: groups.create

Creates a Group.

HTTP request

POST https://cloudidentity.googleapis.com/v1/groups

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
initialGroupConfig

enum (InitialGroupConfig)

Optional. The initial configuration option for the Group.

Request body

The request body contains an instance of Group.

Response body

If successful, the response body contains a newly created instance of Operation.

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-identity.groups
  • https://www.googleapis.com/auth/cloud-identity
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authorization guide.

InitialGroupConfig

The initial configuration options for creating a Group.

Enums
INITIAL_GROUP_CONFIG_UNSPECIFIED Default. Should not be used.
WITH_INITIAL_OWNER The end user making the request will be added as the initial owner of the Group.
EMPTY

An empty group is created without any initial owners.

This can only be used by admins of the domain.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-16 UTC.