---
title: "Create a modifier group"
method: POST
path: "/v3/merchants/{mId}/modifier_groups"
tags: ["INVENTORY"]
---

# Create a modifier group

`POST /v3/merchants/{mId}/modifier_groups`

Creates a new modifier group. After you create a modifier group, you can associate modifiers with the group.

## Path parameters

- `mId` string, required

## Query parameters

- `expand` string

## Headers

- `User-Agent` string, required

## Request body

- object
  - `id` string — Unique identifier of the modifier group.
  - `name` string, required — Name of the modifier group.
  - `alternateName` string — Alternate name of the modifier group.
  - `minRequired` integer — Minimum number of modifiers from this group that must be applied to associated lineItems when using the Register merchant plan.
  - `maxAllowed` integer — Maximum number modifiers from this group that can be applied to associated lineItems when using the Register merchant plan.
  - `showByDefault` boolean — Indicates whether employees receive an automatic message to add modifiers from this group when using the Register merchant plan.
  - `modifiers` object[]
    - `id` string — Unique identifier of the modifier.
    - `name` string — Name of the modifier.
    - `alternateName` string — Alternate name of the modifier.
    - `available` boolean — Indicates whether the modifier is available across all channels. Values: True - default False
    - `price` integer — Additional cost when modifier is used.
    - `modifierGroup` object
      - `id` string — Unique identifier.
  - `modifierIds` string — Unique identifiers of the modifiers in a group. Displays as a read-only, sorted, comma-separated list.
  - `items` object[]
    - `id` string — Unique identifier of the modifier group items.
  - `sortOrder` integer — Sorted list (ascending or descending) that indicates the ranking of the modifier group as compared to other modifier groups.

## Response `200`

Successful response. Modifier group is created.

---

[API](https://skmtc.net/clover/apis/platform-api.md) · [All operations](https://skmtc.net/clover/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clover/platform-api/versions/08da265101a3/schema)