# createSkuGroup (https://developer.godaddy.com/en/docs/references/rest/catalog/sku-group/mutations/createSkuGroup)

***

title: createSkuGroup
description: "Create a new SKU Group."
full: true
----------

mutation

Requires `commerce.product:write`.

Create a new SKU Group.

For `SimpleMoneyInput.value`, send `1999` for $19.99 USD, not `19.99`.

## Required headers

| Header       | Required | Description                                                                                                                     |
| ------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `x-store-id` | Yes      | ID of the store the operation targets. Omitting it returns HTTP 200 with a GraphQL error: `extensions.code: "UNAUTHENTICATED"`. |

Go to [Authentication](https://developer.godaddy.com/docs/api-users/auth) for credential setup.

## Arguments

* `input` `MutationCreateSkuGroupInput!` **required**
  * `label` `String!` **required**
  * `type` `String!` **required**
  * `attributes` `[CreateSKUGroupAttributeInput!]` **optional**
    * `label` `String!` **required**
    * `description` `String` **optional**
    * `metafields` `[CreateMetafieldInput!]` **optional**
      * `key` `String!` **required**
      * `namespace` `String!` **required**
      * `type` `String!` **required** — Metafield value type. Live catalog validation accepts lowercase values such as `boolean`, `string`, `stringMultiLine`, `number`, `numberDecimal`, `date`, `dateTime`, `json`, `measurement`, `url`, `reference`, `money`, `list.string`, `list.number`, `list.numberDecimal`. Uppercase `STRING` is rejected.
      * `value` `String!` **required**
    * `name` `String` **optional**
    * `position` `Int` **optional**
    * `values` `[AssociateAttributeValueInput!]` **optional**
      * `label` `String!` **required**
      * `name` `String` **optional**
      * `position` `Int` **optional**
  * `channels` `[SKUGroupChannelAddInput!]` **optional**
    * `channelId` `String!` **required**
  * `description` `String` **optional**
  * `htmlDescription` `String` **optional**
  * `HTMLDescription` `String` **optional** — Deprecated: Use htmlDescription instead.
  * `mediaObjects` `[CreateMediaObjectInput!]` **optional**
    * `type` `String!` **required** — The type of the media, one of `PHOTO`, `VIDEO`, `IMAGE`, `AUDIO`.
    * `url` `String!` **required**
    * `label` `String` **optional**
    * `metafields` `[CreateMetafieldInput!]` **optional**
      * `key` `String!` **required**
      * `namespace` `String!` **required**
      * `type` `String!` **required** — Metafield value type. Live catalog validation accepts lowercase values such as `boolean`, `string`, `stringMultiLine`, `number`, `numberDecimal`, `date`, `dateTime`, `json`, `measurement`, `url`, `reference`, `money`, `list.string`, `list.number`, `list.numberDecimal`. Uppercase `STRING` is rejected.
      * `value` `String!` **required**
    * `name` `String` **optional**
    * `position` `Int` **optional**
  * `metafields` `[CreateMetafieldInput!]` **optional**
    * `key` `String!` **required**
    * `namespace` `String!` **required**
    * `type` `String!` **required** — Metafield value type. Live catalog validation accepts lowercase values such as `boolean`, `string`, `stringMultiLine`, `number`, `numberDecimal`, `date`, `dateTime`, `json`, `measurement`, `url`, `reference`, `money`, `list.string`, `list.number`, `list.numberDecimal`. Uppercase `STRING` is rejected.
    * `value` `String!` **required**
  * `name` `String` **optional**
  * `options` `[CreateOptionInput!]` **optional**
    * `label` `String!` **required**
    * `type` `String!` **required** — The type of the Option, one of `TEXT`, `NUMBER`, `LIST`. Option Values are only available on the 'LIST' type.
    * `description` `String` **optional**
    * `metafields` `[CreateMetafieldInput!]` **optional**
      * `key` `String!` **required**
      * `namespace` `String!` **required**
      * `type` `String!` **required** — Metafield value type. Live catalog validation accepts lowercase values such as `boolean`, `string`, `stringMultiLine`, `number`, `numberDecimal`, `date`, `dateTime`, `json`, `measurement`, `url`, `reference`, `money`, `list.string`, `list.number`, `list.numberDecimal`. Uppercase `STRING` is rejected.
      * `value` `String!` **required**
    * `name` `String` **optional**
    * `position` `Int` **optional**
    * `prices` `[CreateOptionPriceInput!]` **optional**
      * `value` `SimpleMoneyInput!` **required**
      * `compareAtValue` `SimpleMoneyInput` **optional**
    * `validation` `CreateOptionValidationInput` **optional**
      * `max` `Int` **optional**
      * `min` `Int` **optional**
    * `values` `[CreateOptionValueInput!]` **optional**
      * `label` `String!` **required**
      * `metafields` `[CreateMetafieldInput!]` **optional**
      * `name` `String` **optional**
      * `position` `Int` **optional**
      * `prices` `[CreateOptionValuePriceInput!]` **optional**
  * `references` `[CreateReferenceInput!]` **optional**
    * `origin` `String!` **required**
    * `value` `String!` **required**
  * `shortLabel` `String` **optional** — Deprecated: Use channel-specific overrides for short labels.
  * `skus` `[CreateSKUGroupSKUInput!]` **optional**
    * `label` `String!` **required**
    * `backorderLimit` `Int` **optional**
    * `code` `String` **optional**
    * `cost` `Int` **optional** — DEPRECATED. Use unitCost instead. Deprecated: This cost field cannot specify currency code. Use `unitCost` instead.
    * `description` `String` **optional**
    * `disableInventoryTracking` `Boolean` **optional**
    * `disablePriceOverrides` `Boolean` **optional**
    * `disableShipping` `Boolean` **optional**
    * `eanCode` `String` **optional**
    * `gtinCode` `String` **optional**
    * `htmlDescription` `String` **optional**
    * `inventoryQuantities` `[CreateSKUInventoryInput!]` **optional**
      * `locationId` `String!` **required**
      * `quantity` `Int!` **required**
    * `isbnCode` `String` **optional**
    * `mediaObjects` `[CreateMediaObjectInput!]` **optional**
      * `type` `String!` **required** — The type of the media, one of `PHOTO`, `VIDEO`, `IMAGE`, `AUDIO`.
      * `url` `String!` **required**
      * `label` `String` **optional**
      * `metafields` `[CreateMetafieldInput!]` **optional**
      * `name` `String` **optional**
      * `position` `Int` **optional**
    * `metafields` `[CreateMetafieldInput!]` **optional**
      * `key` `String!` **required**
      * `namespace` `String!` **required**
      * `type` `String!` **required** — Metafield value type. Live catalog validation accepts lowercase values such as `boolean`, `string`, `stringMultiLine`, `number`, `numberDecimal`, `date`, `dateTime`, `json`, `measurement`, `url`, `reference`, `money`, `list.string`, `list.number`, `list.numberDecimal`. Uppercase `STRING` is rejected.
      * `value` `String!` **required**
    * `name` `String` **optional**
    * `prices` `[CreateSKUPriceInput!]` **optional**
      * `value` `SimpleMoneyInput!` **required**
      * `compareAtValue` `SimpleMoneyInput` **optional**
    * `references` `[CreateReferenceInput!]` **optional**
      * `origin` `String!` **required**
      * `value` `String!` **required**
    * `shortLabel` `String` **optional**
    * `status` `String` **optional** — The status of the SKU, one of `DRAFT`, `ACTIVE`, `ARCHIVED`.
    * `unitCost` `SimpleMoneyInput` **optional**
      * `currencyCode` `String!` **required**
      * `value` `Float!` **required** — Integer minor units in the smallest currency unit (for USD, cents: `1999` = $19.99). Send `1999`, not `19.99`.
    * `unitOfWeight` `String` **optional** — The unit of the weight, one of `KG`, `GR`, `LB`, `OZ`.
    * `upcCode` `String` **optional**
    * `weight` `Float` **optional**
  * `status` `String` **optional** — The status of the SKU, one of `DRAFT`, `ACTIVE`, `ARCHIVED`.

## Possible returns

* `SKUGroup` `SKUGroup`

- `activatedAt` `DateTime` **nullable** — The timestamp of when the SKU was activated.
- `archivedAt` `DateTime` **nullable** — The timestamp of when the SKU was archived.
- `attributes` `SKUGroupAttributesConnection` **nullable** — Attributes of SKU Group.
- `channelAssociationMode` `String` **nullable** — The channel association mode for this SKU Group. Can be ALL (uses active channels registered to the store) or SELECTIVE (uses custom channel associations).
- `channels` `SKUGroupChannelsConnection` **nullable** — An association to a channel that exists in the Channel API.
- `compareAtPriceRange` `PriceRange` **nullable** — The compare-at price range of the SKU group, showing min and max compare-at prices of SKUs in the group.
- `createdAt` `DateTime!` **non-null** — The timestamp of when the SKU was created.
- `description` `String` **nullable** — The merchant defined description of the group.
- `htmlDescription` `String` **nullable** — HTML description for the SKU group. Will be used to display rich text content to customers.
- `id` `ID!` **non-null** — The globally-unique ID of the group.
- `label` `String` **nullable** — The display label of the group.
- `lists` `SKUGroupListsConnection` **nullable** — A list is a group of SKU groups that are generally organized by similar characteristics.
- `mediaObjects` `SKUGroupMediaObjectsConnection` **nullable** — Media objects stored under the SKU Group.
- `metafields` `SKUGroupMetafieldsConnection` **nullable**
- `name` `String!` **non-null** — A unique human-friendly identifier for the group.
- `options` `SKUGroupOptionsConnection` **nullable** — An option is a add-on that can be added on to a SKU group.
- `priceRange` `PriceRange` **nullable** — The price range of the SKU group, showing min and max prices of SKUs in the group.
- `references` `SKUGroupReferencesConnection` **nullable** — A reference to the resource in an external service. This can be useful for integrating the resource to any external service.
- `skuCount` `Int` **nullable** — The count of all SKUs associated with the SKU Group. Can be filtered by status. The default statuses are ACTIVE and DRAFT.
- `skus` `SKUGroupSkusConnection` **nullable** — A SKU represents a stock keeping unit (SKU) in the catalog.
- `status` `String!` **non-null** — The status of the SKU Group, one of `DRAFT`, `ACTIVE`, `ARCHIVED`.
- `type` `String!` **non-null** — The type of the SKU Group, typically PHYSICAL or DIGITAL, but can also be a custom type.
- `updatedAt` `DateTime!` **non-null** — The timestamp of when the SKU was updated.
- `HTMLDescription` `String` **nullable** deprecated — HTML description for the SKU group. Will be used to display rich text content to customers. Deprecated: Use htmlDescription instead.
- `shortLabel` `String` **nullable** deprecated — A short label for the group. Can be used instead of the label on smaller screens. Deprecated: Use channel-specific overrides for short labels.
- `SKUs` `SKUGroupSKUsConnection` **nullable** deprecated — A SKU represents a stock keeping unit (SKU) in the catalog. Deprecated: Use skus instead.