Customer Groups — API and MCP
Overview
This area exposes 17 operations. Each of them is at the same time an MCP tool.
This area is behind the module switch module.customer_groups. With the module off, these operations answer 404.
Operations
| Method | Path | Purpose | Permission | Parameters |
|---|---|---|---|---|
GET | /api/v1/customer-groups | Collection of CustomerGroup | customergroups.group.view · customergroups.group.manage | page, active, q |
POST | /api/v1/customer-groups | Create a CustomerGroup | customergroups.group.manage | + body |
POST | /api/v1/customer-groups/preview-rule | Auto-Zuordnungs-Regel vorab auswerten — Liefert Trefferzahl und eine Stichprobe der Kunden, auf die die Regel zutraefe — ohne etwas zu speichern. | customergroups.group.manage | + body |
DELETE | /api/v1/customer-groups/{ulid} | Delete a CustomerGroup | customergroups.group.manage | ulid |
GET | /api/v1/customer-groups/{ulid} | Read one CustomerGroup | customergroups.group.view · customergroups.group.manage | ulid |
PATCH | /api/v1/customer-groups/{ulid} | Update a CustomerGroup | customergroups.group.manage | ulid, + body |
GET | /api/v1/customer-groups/{ulid}/members | Collection of CustomerGroupMember | customergroups.group.view · customergroups.group.manage | ulid, page |
POST | /api/v1/customer-groups/{ulid}/members | Kunde der Gruppe zuordnen — Ordnet einen Kunden (customerUlid) der Gruppe zu. Idempotent je Gruppe und Kunde. | customergroups.group.manage | ulid, + body |
DELETE | /api/v1/customer-groups/{ulid}/members/{memberUlid} | Delete a CustomerGroupMember | customergroups.group.manage | ulid, memberUlid |
GET | /api/v1/customer-groups/{ulid}/price-rules | Collection of CustomerGroupPriceRule | customergroups.group.view · customergroups.group.manage | ulid, page, brandId |
POST | /api/v1/customer-groups/{ulid}/price-rules | Preisregel der Gruppe anlegen — Legt eine Preisregel der Gruppe an. percent ist Prozent mal 100, fixed ein Stückpreis in Cent. | customergroups.group.manage | ulid, + body |
DELETE | /api/v1/customer-groups/{ulid}/price-rules/{ruleUlid} | Delete a CustomerGroupPriceRule | customergroups.group.manage | ulid, ruleUlid |
PATCH | /api/v1/customer-groups/{ulid}/price-rules/{ruleUlid} | Update a CustomerGroupPriceRule | customergroups.group.manage | ulid, ruleUlid, + body |
GET | /api/v1/customer-groups/{ulid}/visibility | Collection of CustomerGroupVisibility | customergroups.group.view · customergroups.group.manage | ulid, page |
POST | /api/v1/customer-groups/{ulid}/visibility | Sichtbarkeit der Gruppe setzen — Setzt die Sichtbarkeit je Gruppe, Geltungsbereich und Referenz neu (Upsert). | customergroups.group.manage | ulid, + body |
DELETE | /api/v1/customer-groups/{ulid}/visibility/{visibilityUlid} | Delete a CustomerGroupVisibility | customergroups.group.manage | ulid, visibilityUlid |
GET | /api/v1/product-group-price-rules | Collection of ProductGroupPriceRule | customergroups.group.view · customergroups.group.manage | productId |
Purpose texts that do not follow the standard pattern are taken verbatim from the interface description in the code.