---
title: "Create a catalog group"
method: POST
path: "/v1/catalog-groups"
tags: ["Catalog Groups"]
---

# Create a catalog group

`POST /v1/catalog-groups`

**Note**: This operation is in the Early Adopter phase. We are actively soliciting feedback from a small set of early adopters before releasing it as generally available. If you want to join this early adopter program, submit a request at [Zuora Global Support](http://support.zuora.com/).

Creates a catalog group which groups a list of product rate plans.

## Headers

- `Idempotency-Key` string
- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Request body

- POSTCatalogGroupRequest
  - `description` string — The description of the catalog group.
  - `name` string — The unique name of the catalog group.
  - `productRatePlans` POSTorPUTCatalogGroupAddProductRatePlan[] — The list of product rate plans to be added to the catalog group.
    - `grade` number — The grade that is assigned for the product rate plan. The value of this field must be a positive integer. The greater the value, the higher the grade. A product rate plan to be added to a Grading catalog group must have one grade. You can specify a grade for a product rate plan in this request or update the product rate plan individually.
    - `id` string — The unique ID of the product rate plan.
  - `type` 'Grading' | 'Display' — The type of the catalog group.

## Response `200`

OK

- CatalogGroupResponse
  - `catalogGroupNumber` string — The automatically generated number of the catalog group with the CG- perfix. For example, CG-00000001.
  - `description` string — The description of the catalog group.
  - `id` string — The ID of the catalog group.
  - `name` string — The name of the catalog group.
  - `productRatePlans` GETCatalogGroupProductRatePlanResponse[] — The list of product rate plans in the catalog group.
    - `description` string, nullable — The description of the product rate plan.
    - `effectiveEndDate` string — The effective end Date of the product rate plan.
    - `effectiveStartDate` string — The effective start date of the product rate plan.
    - `grade` number — The grade of the product rate plan.
    - `id` string — The ID of the product rate plan.
    - `name` string — The name of the product rate plan.
    - `organizationLabels` object[] — The organization(s) that the object belongs to. Note: This field is available only when the Multi-Org feature is enabled.
      - `organizationId` string — The organization ID.
      - `organizationName` string — The organization name.
    - `status` 'Active' | 'Expired' | 'NotStarted' — The status of the product rate plan.
  - `type` 'Grading' | 'Display' — The type of the catalog group.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)