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
Navigate to Groups
- Go to Product Catalog → Groups
- Use Filter and Sort as needed. + Add creates a new group
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
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 |
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.
When you delete a group, every price or feature in that group has its group_id cleared (no orphaned references).
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). |
