> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexprice.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating a group

> Create and list groups. Entity type is set once at creation and cannot be changed.

A group has a single **Entity type** (Price or Feature), chosen when you create it. That type cannot be changed later. Price groups are used for plan charges. Feature groups are used for features.

## Steps to create a group

<Steps>
  <Step title="Navigate to Groups">
    * Go to **Product Catalog** → **Groups**
    * Use **Filter** and **Sort** as needed. **+ Add** creates a new group

    <Frame>
      <img src="https://mintcdn.com/flexprice/o8li027exqawQxCQ/public/images/docs/Groups/list.png?fit=max&auto=format&n=o8li027exqawQxCQ&q=85&s=d989e05d87a80797dc103e46ea58694e" alt="Groups list" width="3420" height="1968" data-path="public/images/docs/Groups/list.png" />
    </Frame>
  </Step>

  <Step title="Create a group">
    * Click **+ Add**
    * In the **Create Group** dialog, enter **Group Name**, **Lookup Key** (unique per tenant and environment), and select **Entity Type** (**Price** or **Feature**)
    * Click **Create Group**

    <Frame>
      <img src="https://mintcdn.com/flexprice/o8li027exqawQxCQ/public/images/docs/Groups/create.png?fit=max&auto=format&n=o8li027exqawQxCQ&q=85&s=ff098d74da1b703f1fec4e4a1897a8f5" alt="Create Group" width="3420" height="1970" data-path="public/images/docs/Groups/create.png" />
    </Frame>
  </Step>
</Steps>

The list shows **Type** (Price or Feature) for each group.

<Frame>
  <img src="https://mintcdn.com/flexprice/e623HncqcXkRezhb/public/images/docs/Groups/list-all-groups.png?fit=max&auto=format&n=e623HncqcXkRezhb&q=85&s=443a6d8fdb67743cb958d4815eeceabf" alt="Groups list — feature groups" width="3420" height="1970" data-path="public/images/docs/Groups/list-all-groups.png" />
</Frame>

## API

| Action      | Method | Endpoint            |
| ----------- | ------ | ------------------- |
| Create      | POST   | `/v1/groups`        |
| Get one     | GET    | `/v1/groups/:id`    |
| List/search | POST   | `/v1/groups/search` |
| Delete      | DELETE | `/v1/groups/:id`    |

**Create:** Body must include `name`, `entity_type` (`"price"` or `"feature"`), `lookup_key`. Response returns `id`. Use it as `group_id` on prices or features.

**List/search:** Filter by `entity_type`, `name`, `lookup_key`, and other supported fields.

**Get one:** Returns the group with `entity_ids` (IDs of prices or features in that group).

**Delete:** Soft-delete. Every entity in that group has its `group_id` cleared.

<Warning>
  When you delete a group, every price or feature in that group has its `group_id` cleared (no orphaned references).
</Warning>

## Validation

| Scope     | Rule                                                                                                                                       |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Group** | `entity_type` must be `"price"` or `"feature"`. `lookup_key` is required and must be unique per tenant and environment (published groups). |