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

# POST /v1/{+parent}/entryGroups

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

Creates an entry group. An entry group contains logically related entries together with [Cloud Identity and Access Management](/data-catalog/docs/concepts/iam) policies. These policies specify users who can create, edit, and view entries within entry groups. Data Catalog automatically creates entry groups with names that start with the `@` symbol for the following resources: * BigQuery entries (`@bigquery`) * Pub/Sub topics (`@pubsub`) * Dataproc Metastore services (`@dataproc_metastore_{SERVICE_NAME_HASH}`) You can create your own entry groups for Cloud Storage fileset entries and custom entries together with the corresponding IAM policies. User-created entry groups can't contain the `@` symbol, it is reserved for automatically created groups. Entry groups, like entries, can be searched. A maximum of 10,000 entry groups may be created per organization across all locations. You must enable the Data Catalog API in the project identified by the `parent` parameter. For more information, see [Data Catalog resource project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).

## Path parameters

- `parent` string, required

## Query parameters

- `entryGroupId` string

## Request body

- GoogleCloudDatacatalogV1EntryGroup — Entry group metadata. An `EntryGroup` resource represents a logical grouping of zero or more Data Catalog Entry resources.
  - `name` string — Identifier. The resource name of the entry group in URL format. Note: The entry group itself and its child resources might not be stored in the location specified in its name.
  - `displayName` string — A short name to identify the entry group, for example, "analytics data - jan 2011". Default value is an empty string.
  - `description` string — Entry group description. Can consist of several sentences or paragraphs that describe the entry group contents. Default value is an empty string.
  - `dataCatalogTimestamps` GoogleCloudDatacatalogV1SystemTimestamps — Timestamps associated with this resource in a particular system.
    - `createTime` string, google-datetime — Creation timestamp of the resource within the given system.
    - `updateTime` string, google-datetime — Timestamp of the last modification of the resource or its metadata within a given system. Note: Depending on the source system, not every modification updates this timestamp. For example, BigQuery timestamps every metadata modification but not data or permission changes.
    - `expireTime` string, google-datetime — Output only. Expiration timestamp of the resource within the given system. Currently only applicable to BigQuery resources.
  - `transferredToDataplex` boolean — Optional. When set to [true], it means DataCatalog EntryGroup was transferred to Dataplex Universal Catalog. It makes EntryGroup and its Entries to be read-only in DataCatalog. However, new Tags on EntryGroup and its Entries can be created. After setting the flag to [true] it cannot be unset.

## Response `200`

Successful response

---

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